C#'da bir ayrılmış birlik nasıl oluşturabilirim?

C#'da bir ayrılmış birlik oluşturmak için iç içe alt sınıflara sahip soyut bir sınıf tanımlayabilirsiniz. Her alt sınıf olası bir durumu temsil eder, örneğin başarı veya hata durumu, ve bu durumları işlemek için desen eşleme kullanabilirsiniz.

Ayrılmış birliklerin ele alınmasında IronPDF kütüphanesinin rolü nedir?

IronPDF kütüphanesi, ayrılmış birliklerle birlikte PDF oluşturma sonuçlarını yönetmek için kullanılabilir. Bu sonuçları ayrılmış birlikler olarak modelleyerek, tip güvenliğini sağlayabilir ve hem başarılı PDF oluşturma hem de meydana gelen hataları ele alabilirsiniz.

Desen eşleme, C#'daki ayrılmış birlikleri nasıl geliştirir?

Desen eşleme, C#'daki ayrılmış birlikleri geliştirerek, geliştiricilerin her olası durumu zarif bir şekilde ele almasını sağlar. Desen eşlemeyle, farklı sonuçları güvenli bir şekilde yönetebilir ve tüm senaryoların derleme zamanında kapsandığından emin olabilirsiniz.

C#'da PDF oluşturma için ayrılmış birlikler neden yararlıdır?

C#'da PDF oluşturma için ayrılmış birlikler, başarı ve hata durumlarını ele almanın yapısal bir yolunu sunduğundan yararlıdır. Bu yaklaşım, potansiyel sorunların derleme zamanında ele alınmasını garanti ederek, PDF oluşturma sırasında çalışma zamanı hatalarını azaltır.

C#'da ek işlevsellik için ayrılmış birlikler genişletilebilir mi?

Evet, ayrılmış birlikler, genişletme yöntemleri kullanılarak ek işlevsellikle genişletilebilir. Bu, temel yapıyı değiştirmeden bir PDF oluşturmanın başarı durumunu kontrol etmek gibi özel davranışlar eklemenize olanak tanır.

C#'da ayrılmış birlikleri yerel destek olmadan simüle etmenin bir yolu var mı?

Evet, C#'da ayrılmış birliklerin yerel desteği olmasa da, bunlar sınıf hiyerarşileri kullanılarak simüle edilebilir. Farklı olası sonuçları, örneğin başarı veya başarısızlık durumlarını temsil etmek için iç içe sınıflar ile bir soyut ana sınıf kullanılabilir.

C# geliştiricileri, PDF oluşturmadaki hataları nasıl etkin bir şekilde yönetebilirler?

C# geliştiricileri, olası sonuçları modellemek için ayrılmış birlikler kullanarak PDF oluşturmadaki hataları etkin bir şekilde yönetebilirler. Bu yaklaşım, hataların derleme zamanında ele alınmasını sağlayarak, kodun güvenilirliğini ve sürdürülebilirliğini artırır.

C# projeleri için Ayrılmış birliklerle IronPDF kullanımının avantajları nelerdir?

C# projelerinde ayrılmış birliklerle IronPDF kullanmak, PDF oluşturma sırasında güçlü hata yönetimi avantajı sunar. Bu kombinasyon, başarılı işlemler ile hatalar arasında belirgin bir ayrım sağlayarak kod güvenliğini ve güvenilirliğini artırır.

Ayrılmış birlikler, C#'da tip güvenliğine nasıl katkıda bulunur?

Ayrılmış birlikler, C#'da tüm potansiyel durumların derleme sırasında ele alınmasını sağlayarak tip güvenliğine katkıda bulunur. Bu, çalışma zamanı hatalarının olasılığını azaltır ve kodu daha öngörülebilir ve bakımı daha kolay hale getirir.

C# PDF Kütüphanesi

Explore IronPDF Ücretsiz Denemeye Başlayın

HTML'den PDF'e

Online Demo Tüm Kod Örneklerini Görün

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >Install-Package IronPdf

Install-Package IronPdf

GELIŞTIRICI GÜNCELLEMELERI

C# Ayrım Yapan Birlik (Geliştiriciler İçin Nasıl Çalışır)

Jacob Mellor

Updated: 28 Temmuz 2025

Ayırt Edilmiş Birleşimler, etik sınıflar veya toplam türler olarak da bilinir, farklı biçimler alabilen, ancak iyi tanımlanmış ve sınırlı olasılıklı veri türünü modellemek için güçlü bir araçtır. C#, bazı diğer diller (örneğin F# veya Rust) gibi yerel ayırt edilmiş birleşimlere sahip olmasa da, dilde birkaç teknik kullanarak ayırt edilmiş birleşimleri simüle edebilirsiniz. Bu eğitimde, ayırt edilmiş birleşimlere dalacağız, C#'ta nasıl uygulanacağını ve IronPDF kütüphanesi ile pratik kullanım durumunu ele alacağız.

Ayırt Edilmiş Birleşim Nedir?

Basit terimlerle, ayırt edilmiş birleşim, önceden tanımlanmış birkaç form veya değeri tutabilen bir türdür. Derleme zamanında yalnızca geçerli durumların ele alındığını garanti ederek, farklı türleri veya değerleri kapsayan tür güvenli bir yapı oluşturma olanağı sağlar.

Bir işlemin sonucunu temsil etmek istediğiniz bir senaryoyu düşünün. İşlem ya başarılı olabilir ve bazı veriler döndürebilir ya da başarısız olabilir ve bir hata mesajı döndürebilir. Ayırt edilmiş birleşim, bu iki olası sonucu tek bir türde temsil etmenizi sağlar.

Example: Simulating Discriminated Union in C#

İşte sınıf yapısını kullanarak C#'ta ayırt edilmiş bir birleşimi nasıl simüle edebileceğinize dair bir örnek:

// Define an abstract base class representing the operation result.
public abstract class OperationResult<t>
{
    // Private constructor to ensure the class cannot be instantiated directly.
    private OperationResult() { }

    // Nested class representing a successful operation result.
    public sealed class Success : OperationResult<t>
    {
        public T Value { get; }
        
        public Success(T value) => Value = value;

        public override string ToString() => $"Success: {Value}";
    }

    // Nested class representing a failed operation result.
    public sealed class Failure : OperationResult<t>
    {
        public string Error { get; }
        
        public Failure(string error) => Error = error;

        public override string ToString() => $"Failure: {Error}";
    }

    // Factory method to create a successful operation result.
    public static OperationResult<t> CreateSuccess(T value) => new Success(value);

    // Factory method to create a failed operation result.
    public static OperationResult<t> CreateFailure(string error) => new Failure(error);
}

// Define an abstract base class representing the operation result.
public abstract class OperationResult<t>
{
    // Private constructor to ensure the class cannot be instantiated directly.
    private OperationResult() { }

    // Nested class representing a successful operation result.
    public sealed class Success : OperationResult<t>
    {
        public T Value { get; }
        
        public Success(T value) => Value = value;

        public override string ToString() => $"Success: {Value}";
    }

    // Nested class representing a failed operation result.
    public sealed class Failure : OperationResult<t>
    {
        public string Error { get; }
        
        public Failure(string error) => Error = error;

        public override string ToString() => $"Failure: {Error}";
    }

    // Factory method to create a successful operation result.
    public static OperationResult<t> CreateSuccess(T value) => new Success(value);

    // Factory method to create a failed operation result.
    public static OperationResult<t> CreateFailure(string error) => new Failure(error);
}

Bu örnekte, OperationResult<t>, ayrık birlik türümüzü temsil eden soyut bir sınıftır. Bu, ya tür değeri T olan bir Success ya da bir hata mesajıyla bir Failure olabilir. Özel kurucu, bu tür bir sınıfın örneklerinin yalnızca önceden tanımlanmış durumlar aracılığıyla oluşturulabileceğini garanti eder.

Ayırt Edilmiş Birleşimlerle Desen Eşleme Kullanmak

C#, ayırt edilmiş birleşimlerle iyi çalışan güçlü desen eşleme yetenekleri sağlar. Farklı durumları bir switch ifadesi kullanarak işleyecek bir yöntemle OperationResult<t> örneğimizi genişletelim.

// Method to handle the result using pattern matching.
public string HandleResult(OperationResult<int> result) =>
    result switch
    {
        OperationResult<int>.Success success => $"Operation succeeded with value: {success.Value}",
        OperationResult<int>.Failure failure => $"Operation failed with error: {failure.Error}",
        _ => throw new InvalidOperationException("Unexpected result type")
    };

// Method to handle the result using pattern matching.
public string HandleResult(OperationResult<int> result) =>
    result switch
    {
        OperationResult<int>.Success success => $"Operation succeeded with value: {success.Value}",
        OperationResult<int>.Failure failure => $"Operation failed with error: {failure.Error}",
        _ => throw new InvalidOperationException("Unexpected result type")
    };

' Method to handle the result using pattern matching.
'INSTANT VB TODO TASK: The following 'switch expression' was not converted by Instant VB:
'public string HandleResult(OperationResult<int> result) => result switch
'	{
'		OperationResult<int>.Success success => $"Operation succeeded with value: {success.Value}",
'		OperationResult<int>.Failure failure => $"Operation failed with error: {failure.Error}",
'		_ => throw new InvalidOperationException("Unexpected result type")
'	};

' Method to handle the result using pattern matching.
'INSTANT VB TODO TASK: The following 'switch expression' was not converted by Instant VB:
'public string HandleResult(OperationResult<int> result) => result switch
'	{
'		OperationResult<int>.Success success => $"Operation succeeded with value: {success.Value}",
'		OperationResult<int>.Failure failure => $"Operation failed with error: {failure.Error}",
'		_ => throw new InvalidOperationException("Unexpected result type")
'	};

Buradaki switch ifadesi, OperationResult<int>'un hem Success hem de Failure durumlarını ele alır. Bu, tüm olası durumların derleme zamanında kapsandığını garanti eder, tür güvenliği sağlar ve çalışma zamanı hataları riskini azaltır.

Ayırt Edilmiş Birleşimler İçin Genişletme Yöntemleri

Ayırt edilmiş birleşimlerin işlevselliğini genişletme yöntemlerini kullanarak genişletebilirsiniz. Örneğin, sonucun başarı olup olmadığını belirlemek için OperationResult<t> için bir genişletme yöntemi oluşturalım:

// Static class to hold extension methods for OperationResult<t>.
public static class OperationResultExtensions
{
    // Extension method to check if the operation result indicates success. 
    public static bool IsSuccess<t>(this OperationResult<t> result) =>
        result is OperationResult<t>.Success;
}

// Static class to hold extension methods for OperationResult<t>.
public static class OperationResultExtensions
{
    // Extension method to check if the operation result indicates success. 
    public static bool IsSuccess<t>(this OperationResult<t> result) =>
        result is OperationResult<t>.Success;
}

' Static class to hold extension methods for OperationResult(Of T).
Public Module OperationResultExtensions

    ' Extension method to check if the operation result indicates success.
    <System.Runtime.CompilerServices.Extension>
    Public Function IsSuccess(Of T)(ByVal result As OperationResult(Of T)) As Boolean
        Return TypeOf result Is OperationResult(Of T).Success
    End Function

End Module

' Static class to hold extension methods for OperationResult(Of T).
Public Module OperationResultExtensions

    ' Extension method to check if the operation result indicates success.
    <System.Runtime.CompilerServices.Extension>
    Public Function IsSuccess(Of T)(ByVal result As OperationResult(Of T)) As Boolean
        Return TypeOf result Is OperationResult(Of T).Success
    End Function

End Module

Bu statik yöntem, sonucun Success durumunun bir örneği olup olmadığını kontrol eder.

Native Support for Discriminated Unions in C#

C#'ın diğer diller gibi ayrım yapıcı birlikler için yerel desteği yoktur, ancak böyle bir özelliğin eklenmesi hakkında toplumda süregelen tartışmalar bulunmaktadır. Yerel ayrım yapıcı birlikler, sınıf hiyerarşilerine güvenmeksizin birlik türlerini tanımlamayı ve bunlarla çalışmayı kolaylaştıracaktır.

Derleyici Hataları ve Tür Güvenliği

Ayrım yapıcı birliklerin ana faydalarından biri, sağladıkları tür güvenliğidir. Tüm olası durumlar derleme zamanında bilindiğinden, derleyici tüm durumların ele alındığını zorlayabilir. Bu, daha az çalışma zamanı hatasına yol açar ve kodun daha az hata yapmasına neden olur.

Örneğin, bir anahtar cümlede belirli bir durumu ele almayı unutursanız, derleyici bir hata üretir ve eksik durumu ele almanızı sağlar. Bu özellikle birden fazla olası duruma sahip karmaşık veri yapılarıyla uğraşırken faydalıdır.

Using IronPDF with Discriminated Unions in C#

C# Ayrık Birlik (Geliştiriciler İçin Nasıl Çalışır): Şekil 1 - IronPDF

IronPDF, geliştiricilere HTML'den PDF dosyaları oluşturması ve PDF dosyalarını zahmetsizce değiştirmesi için yardımcı olan bir C# PDF kütüphanesidir. C#'da PDF'ler üzerinde çalışırken, IronPDF ile ayrım yapıcı birlikleri entegre ederek PDF dosyaları oluştururken veya işlerken farklı senaryoları ele alabilirsiniz. Örneğin, bir PDF'yi başarıyla oluşturan veya bir hata ile karşılaşan bir işlem olabilir. Ayrım yapıcı birlikler, bu süreci açıkça modellemenize olanak tanır. IronPDF kullanarak bir PDF oluşturduğumuz ve sonucu ayrım yapıcı bir birlik olarak döndürdüğümüz basit bir örnek oluşturalım.

// Using directives for necessary namespaces.
using IronPdf;
using System;

// Define an abstract base class representing the PDF generation result.
public abstract class PdfResult
{
    // Private constructor to ensure the class cannot be instantiated directly.
    private PdfResult() { }

    // Nested class representing a successful PDF generation result.
    public sealed class Success : PdfResult
    {
        public PdfDocument Pdf { get; }
        
        public Success(PdfDocument pdf) => Pdf = pdf;

        public override string ToString() => "PDF generation succeeded";
    }

    // Nested class representing a failed PDF generation result.
    public sealed class Failure : PdfResult
    {
        public string ErrorMessage { get; }
        
        public Failure(string errorMessage) => ErrorMessage = errorMessage;

        public override string ToString() => $"PDF generation failed: {ErrorMessage}";
    }

    // Factory method to create a successful PDF result.
    public static PdfResult CreateSuccess(PdfDocument pdf) => new Success(pdf);

    // Factory method to create a failed PDF result.
    public static PdfResult CreateFailure(string errorMessage) => new Failure(errorMessage);
}

// Class to generate PDFs using IronPDF.
public class PdfGenerator
{
    // Method to generate a PDF from HTML content and return the result as a PdfResult.
    public PdfResult GeneratePdf(string htmlContent)
    {
        try
        {
            // Create a new ChromePdfRenderer instance.
            var renderer = new ChromePdfRenderer();

            // Attempt to render the HTML content as a PDF.
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return a success result with the generated PDF.
            return PdfResult.CreateSuccess(pdf);
        }
        catch (Exception ex)
        {
            // Return a failure result with the error message if an exception occurs.
            return PdfResult.CreateFailure(ex.Message);
        }
    }
}

// Using directives for necessary namespaces.
using IronPdf;
using System;

// Define an abstract base class representing the PDF generation result.
public abstract class PdfResult
{
    // Private constructor to ensure the class cannot be instantiated directly.
    private PdfResult() { }

    // Nested class representing a successful PDF generation result.
    public sealed class Success : PdfResult
    {
        public PdfDocument Pdf { get; }
        
        public Success(PdfDocument pdf) => Pdf = pdf;

        public override string ToString() => "PDF generation succeeded";
    }

    // Nested class representing a failed PDF generation result.
    public sealed class Failure : PdfResult
    {
        public string ErrorMessage { get; }
        
        public Failure(string errorMessage) => ErrorMessage = errorMessage;

        public override string ToString() => $"PDF generation failed: {ErrorMessage}";
    }

    // Factory method to create a successful PDF result.
    public static PdfResult CreateSuccess(PdfDocument pdf) => new Success(pdf);

    // Factory method to create a failed PDF result.
    public static PdfResult CreateFailure(string errorMessage) => new Failure(errorMessage);
}

// Class to generate PDFs using IronPDF.
public class PdfGenerator
{
    // Method to generate a PDF from HTML content and return the result as a PdfResult.
    public PdfResult GeneratePdf(string htmlContent)
    {
        try
        {
            // Create a new ChromePdfRenderer instance.
            var renderer = new ChromePdfRenderer();

            // Attempt to render the HTML content as a PDF.
            var pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return a success result with the generated PDF.
            return PdfResult.CreateSuccess(pdf);
        }
        catch (Exception ex)
        {
            // Return a failure result with the error message if an exception occurs.
            return PdfResult.CreateFailure(ex.Message);
        }
    }
}

' Using directives for necessary namespaces.
Imports IronPdf
Imports System

' Define an abstract base class representing the PDF generation result.
Public MustInherit Class PdfResult
    ' Private constructor to ensure the class cannot be instantiated directly.
    Private Sub New()
    End Sub

    ' Nested class representing a successful PDF generation result.
    Public NotInheritable Class Success
        Inherits PdfResult
        Public ReadOnly Property Pdf As PdfDocument

        Public Sub New(pdf As PdfDocument)
            Me.Pdf = pdf
        End Sub

        Public Overrides Function ToString() As String
            Return "PDF generation succeeded"
        End Function
    End Class

    ' Nested class representing a failed PDF generation result.
    Public NotInheritable Class Failure
        Inherits PdfResult
        Public ReadOnly Property ErrorMessage As String

        Public Sub New(errorMessage As String)
            Me.ErrorMessage = errorMessage
        End Sub

        Public Overrides Function ToString() As String
            Return $"PDF generation failed: {ErrorMessage}"
        End Function
    End Class

    ' Factory method to create a successful PDF result.
    Public Shared Function CreateSuccess(pdf As PdfDocument) As PdfResult
        Return New Success(pdf)
    End Function

    ' Factory method to create a failed PDF result.
    Public Shared Function CreateFailure(errorMessage As String) As PdfResult
        Return New Failure(errorMessage)
    End Function
End Class

' Class to generate PDFs using IronPDF.
Public Class PdfGenerator
    ' Method to generate a PDF from HTML content and return the result as a PdfResult.
    Public Function GeneratePdf(htmlContent As String) As PdfResult
        Try
            ' Create a new ChromePdfRenderer instance.
            Dim renderer = New ChromePdfRenderer()

            ' Attempt to render the HTML content as a PDF.
            Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)

            ' Return a success result with the generated PDF.
            Return PdfResult.CreateSuccess(pdf)
        Catch ex As Exception
            ' Return a failure result with the error message if an exception occurs.
            Return PdfResult.CreateFailure(ex.Message)
        End Try
    End Function
End Class

' Using directives for necessary namespaces.
Imports IronPdf
Imports System

' Define an abstract base class representing the PDF generation result.
Public MustInherit Class PdfResult
    ' Private constructor to ensure the class cannot be instantiated directly.
    Private Sub New()
    End Sub

    ' Nested class representing a successful PDF generation result.
    Public NotInheritable Class Success
        Inherits PdfResult
        Public ReadOnly Property Pdf As PdfDocument

        Public Sub New(pdf As PdfDocument)
            Me.Pdf = pdf
        End Sub

        Public Overrides Function ToString() As String
            Return "PDF generation succeeded"
        End Function
    End Class

    ' Nested class representing a failed PDF generation result.
    Public NotInheritable Class Failure
        Inherits PdfResult
        Public ReadOnly Property ErrorMessage As String

        Public Sub New(errorMessage As String)
            Me.ErrorMessage = errorMessage
        End Sub

        Public Overrides Function ToString() As String
            Return $"PDF generation failed: {ErrorMessage}"
        End Function
    End Class

    ' Factory method to create a successful PDF result.
    Public Shared Function CreateSuccess(pdf As PdfDocument) As PdfResult
        Return New Success(pdf)
    End Function

    ' Factory method to create a failed PDF result.
    Public Shared Function CreateFailure(errorMessage As String) As PdfResult
        Return New Failure(errorMessage)
    End Function
End Class

' Class to generate PDFs using IronPDF.
Public Class PdfGenerator
    ' Method to generate a PDF from HTML content and return the result as a PdfResult.
    Public Function GeneratePdf(htmlContent As String) As PdfResult
        Try
            ' Create a new ChromePdfRenderer instance.
            Dim renderer = New ChromePdfRenderer()

            ' Attempt to render the HTML content as a PDF.
            Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)

            ' Return a success result with the generated PDF.
            Return PdfResult.CreateSuccess(pdf)
        Catch ex As Exception
            ' Return a failure result with the error message if an exception occurs.
            Return PdfResult.CreateFailure(ex.Message)
        End Try
    End Function
End Class

PdfResult sınıfı, iki duruma sahip bir ayrık birlik temsil eder: Success ve Failure. Success durumu, bir PdfDocument içerirken, Failure durumu bir hata mesajı tutar. GeneratePdf yöntemi bir HTML dizesi alır, IronPDF kullanarak bir PDF oluşturmayı dener ve sonucu bir PdfResult olarak döndürür. Eğer PDF oluşturma başarılı olursa, oluşturulan PDF ile Success durumunu döndürür. Bir istisna oluşursa, hata mesajıyla birlikte Failure durumunu döndürür.

Sonuç

C# Ayrık Birlik (Geliştiriciler İçin Nasıl Çalışır): Şekil 2 - Lisanslama

C# dillinde ayrım yapıcı birlikler, birden fazla olası duruma sahip verileri modellemenin güçlü ve esnek bir yolunu sunar. C# ayrım yapıcı birlikleri desteklemese de, bunları sınıf hiyerarşileri, desen eşleştirme ve diğer tekniklerle simüle edebilirsiniz. Ortaya çıkan kod daha tür güvenli, daha az hatalı ve daha kolay bakım yapılabilir hale gelir.

IronPDF, yazılıma ön ödeme gerektirmeyen bir ücretsiz deneme sunar. Tüm özellikleri keşfedebilir ve gereksinimlerinize nasıl uyduğunu görebilirsiniz. Denemenizden sonra, lisanslar $999 başlangıç fiyatı ile mevcuttur.

Jacob Mellor

Mühendislik ekibiyle şimdi sohbet edin

Teknoloji Direktörü

Jacob Mellor, Iron Software'de Baş Teknoloji Yöneticisidir ve C# PDF teknolojisinde öncü bir mühendisdir. Iron Software'ın ana kod tabanının ilk geliştiricisi olarak, CEO Cameron Rimington ile birlikte şirketin ürün mimarisini 50'den fazla kişilik bir şirkete dönüştürmüştür ve NASA, Tesla ve dünya genelindeki devlet kurumlarına hizmet etmektedir.

...

Daha Fazla Oku