C# Ayrık Birleşimler (Geliştiriciler için Nasıl Çalışır)

C#'ta Ayrımcı Birlikler Nedir?

Ayrımcı birlikler, etiketli birlikler veya birlik türleri olarak da bilinir, bir değişkenin sınırlı bir olası seçenek kümesinden bir değer tutmasına izin verir, burada her seçenek benzersiz bir durum tanımlayıcı ile ilişkilidir.

F# gibi diğer dillerde, bunları birlik anahtar kelimesi kullanarak tanımlayabilirsiniz. C# bu özelliği yerel olarak sağlamaz, ancak geliştiriciler bunları taklit etmek için kayıtlar, sınıflar ve anahtar kelime ifadelerinin zekice kombinasyonlarını kullanabilir.

Örneğin:

public abstract record PdfAction;
public record GenerateReport(string ReportName) : PdfAction;
public record LogError(string Message) : PdfAction;
public record ExportToExcel(string FilePath) : PdfAction;

public abstract record PdfAction;
public record GenerateReport(string ReportName) : PdfAction;
public record LogError(string Message) : PdfAction;
public record ExportToExcel(string FilePath) : PdfAction;

Public MustOverride ReadOnly Property PdfAction() As record
public record GenerateReport(String ReportName) : PdfAction
public record LogError(String Message) : PdfAction
public record ExportToExcel(String FilePath) : PdfAction

Yukarıdaki her bir kayıt, birliğin tek bir durumunu temsil eder. Temel PdfAction türü ayırt edici özelliktir.

Ayrımcı Birlikler Neden IronPDF İş Akışlarında Önemlidir?

IronPDF kullanarak bir PDF rapor oluşturucu oluşturduğunuzu ve kullanıcı girdisine göre farklı işlemler yapmanız gerektiğini hayal edin—belki de bir PDF oluşturma, bir hatayı günlüğe kaydetme veya verileri dışa aktarma.

C#'ta ayrımcı birlikleri kullanmak, bu seçenek türlerini düzenli bir şekilde temsil etmenizi sağlar, bu da derleme zamanı güvenliği, daha az hata ve daha net mantıkla sonuçlanır.

İşte IronPDF ile nasıl kullanabileceğiniz:

void HandlePdfAction(PdfAction action)
{
    switch (action)
    {
        case GenerateReport r:
            var pdf = new IronPdf.HtmlToPdf().RenderHtmlAsPdf("<h1>" + r.ReportName + "</h1>");
            pdf.SaveAs(r.ReportName + ".pdf");
            break;
        case LogError e:
            Console.WriteLine("Logging Error: " + e.Message);
            break;
        case ExportToExcel x:
            Console.WriteLine("Exporting to Excel at " + x.FilePath);
            break;
        default:
            throw new NotSupportedException("Unknown action");
    }
}

void HandlePdfAction(PdfAction action)
{
    switch (action)
    {
        case GenerateReport r:
            var pdf = new IronPdf.HtmlToPdf().RenderHtmlAsPdf("<h1>" + r.ReportName + "</h1>");
            pdf.SaveAs(r.ReportName + ".pdf");
            break;
        case LogError e:
            Console.WriteLine("Logging Error: " + e.Message);
            break;
        case ExportToExcel x:
            Console.WriteLine("Exporting to Excel at " + x.FilePath);
            break;
        default:
            throw new NotSupportedException("Unknown action");
    }
}

Private Sub HandlePdfAction(ByVal action As PdfAction)
	Select Case action
'INSTANT VB TODO TASK: The following 'case' pattern variable is not converted by Instant VB:
'ORIGINAL LINE: case GenerateReport r:
		Case GenerateReport r
			Dim pdf = (New IronPdf.HtmlToPdf()).RenderHtmlAsPdf("<h1>" & r.ReportName & "</h1>")
			pdf.SaveAs(r.ReportName & ".pdf")
'INSTANT VB TODO TASK: The following 'case' pattern variable is not converted by Instant VB:
'ORIGINAL LINE: case LogError e:
		Case LogError e
			Console.WriteLine("Logging Error: " & e.Message)
'INSTANT VB TODO TASK: The following 'case' pattern variable is not converted by Instant VB:
'ORIGINAL LINE: case ExportToExcel x:
		Case ExportToExcel x
			Console.WriteLine("Exporting to Excel at " & x.FilePath)
		Case Else
			Throw New NotSupportedException("Unknown action")
	End Select
End Sub

Bu yaklaşım kodunuzu düzenli ve sağlam tutar ve geliştiricilerin tüm olası seçenekleri tek bir yerde anlamasını kolaylaştırır.

C#'ta Ayrımcı Birlikleri Simüle Etme – Yapı vs. Kayıt vs. Sınıf

C# birlik anahtar kelimesine sahip olmamasına rağmen, ayrımcı birlikleri şu şekilde simüle edebilirsiniz:

• Kayıtlar: Değişmez veriler için idealdir ve desen eşleştirmeyi düzenli bir şekilde destekler.
• Sınıflar: Kalıtım ve referans semantiği ile daha esnektir.
• Yapılar: Değer türleri için kullanışlıdır, ancak referans türleri veya kalıtım ile uğraşırken daha az esnektir.

Performans ve bellek yerleşimi önemliyse—örneğin, yüksek verimliliğe sahip PDF kaydı yaparken—yapı ayrımcı birliklerini dikkatlice kullanmayı düşünebilirsiniz:

public interface IAction { }
public readonly struct SaveAction : IAction
{
    public string FileName { get; }
    public SaveAction(string fileName) => FileName = fileName;
}

public interface IAction { }
public readonly struct SaveAction : IAction
{
    public string FileName { get; }
    public SaveAction(string fileName) => FileName = fileName;
}

Public Interface IAction
End Interface
'INSTANT VB WARNING: VB has no equivalent to the C# readonly struct:
'ORIGINAL LINE: public readonly struct SaveAction : IAction
Public Structure SaveAction
	Implements IAction

	Public ReadOnly Property FileName() As String
	Public Sub New(ByVal fileName As String)
		Me.FileName = fileName
	End Sub
End Structure

Not: Yapılar ile desen eşleştirme avantajlarının bir kısmını, özellikle anahtar kelime ifadelerine güvenirken, kaybedersiniz.

C#'ta Ayrımcı Birlikleri Kullanmanın Faydaları

Bu yazılım mühendisliği desenini benimsemenin birkaç önemli avantajı vardır:

• Derleme zamanı güvenliği: Çalışma zamanından önce anahtar kelime ifadesinde eksik durumları yakalarsınız.
• Daha net mantık: İsimlendirilmiş işlemlerle işlemleri yazmak, yorumlamak ve mantık yürütmek daha kolaydır.
• Kapsamların ayrılması: Davranışları verilere dayalı olarak tür hiyerarşilerinden ziyade ayırırsınız.
• Yeniden yapılandırma kolaylığı: Durumları eklemek veya çıkarmak daha da kolaylaşır.

IronPDF ile eşleştirildiğinde, bu kullanıcı girdisini yönetmeyi, işleme mantığını veya farklı değer hatları ile dinamik şablonlar oluşturmayı kolaylaştırır.

IronPDF ile Ayrımcı Birlikleri Ne Zaman Kullanmalı

Bu desenin sıklıkla öne çıktığı bazı pratik senaryolar şunlardır:

• PDF Oluşturma İş Akışları: Belge yaşam döngüsünde (oluştur, kaydet, e-posta) farklı adımlar.
• İzin Modelleri: Farklı kullanıcı erişim seviyelerini temsil etme.
• Kayıt Sistemleri: Günlük seviyeleri (bilgi, hata, hata ayıklama) için ayrımcı birlik türlerini kullanma.
• Birim Testleri: Test işlemlerini uzun süreli mantık ağaçları olarak birlik türleri olarak tanımlama.
• Dışa Aktarma Seçenekleri: PDF, Excel, Word gibi çıktı hedeflerini birlik örnekleri olarak temsil etme.

Örnek – UI Olaylarından PDF İşlemlerinin Ele Alınması

Diyelim ki UI olaylarını yakalıyorsunuz ve bunları ayrımcı birlikler kullanarak IronPDF görevlerine yönlendirmek istiyorsunuz:

public abstract record UserAction;
public record GeneratePdf(string HtmlContent, string FileName) : UserAction;
public record ShowMessage(string Text) : UserAction;
public record ExitApplication() : UserAction;
void OnUserEvent(UserAction action)
{
    switch (action)
    {
        case GeneratePdf pdf:
            var renderer = new IronPdf.HtmlToPdf();
            var document = renderer.RenderHtmlAsPdf(pdf.HtmlContent);
            document.SaveAs(pdf.FileName);
            break;
        case ShowMessage msg:
            MessageBox.Show(msg.Text);
            break;
        case ExitApplication:
            Application.Exit();
            break;
    }
}

public abstract record UserAction;
public record GeneratePdf(string HtmlContent, string FileName) : UserAction;
public record ShowMessage(string Text) : UserAction;
public record ExitApplication() : UserAction;
void OnUserEvent(UserAction action)
{
    switch (action)
    {
        case GeneratePdf pdf:
            var renderer = new IronPdf.HtmlToPdf();
            var document = renderer.RenderHtmlAsPdf(pdf.HtmlContent);
            document.SaveAs(pdf.FileName);
            break;
        case ShowMessage msg:
            MessageBox.Show(msg.Text);
            break;
        case ExitApplication:
            Application.Exit();
            break;
    }
}

Public MustOverride ReadOnly Property UserAction() As record
public record GeneratePdf(String HtmlContent, String FileName) : UserAction
public record ShowMessage(String Text) : UserAction
public record ExitApplication() : UserAction
'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'void OnUserEvent(UserAction action)
'{
'	switch (action)
'	{
'		case GeneratePdf pdf:
'			var renderer = New IronPdf.HtmlToPdf();
'			var document = renderer.RenderHtmlAsPdf(pdf.HtmlContent);
'			document.SaveAs(pdf.FileName);
'			break;
'		case ShowMessage msg:
'			MessageBox.Show(msg.Text);
'			break;
'		case ExitApplication:
'			Application.@Exit();
'			break;
'	}
'}

Bu, olayları net bir mantıkla temsil etmenize ve genel nesne türlerine veya aşırı dinamik ele almaya olan bağımlılığı azaltır.

Gelecek Perspektifi – C# Hiç Yerel Ayrımcı Birlikleri Destekleyecek mi?

C# için ayrımcı birlikler için yerel destek ekleme önerisi zaten vardı, özellikle daha ifade edici tür sistemlerine olan talep arttıkça. Dil henüz gerçek bir birlik anahtar kelimesi tanıtmamış olsa da, C# evrimleşmeye devam ediyor—kayıtlar, desen eşleştirme ve anahtar kelime ifadeleri gibi özellikler, tam ayrımcı birlik işlevselliğine daha da yaklaşıyor.

Modern, fonksiyonel dostu dil yapılarıyla ilgilenen .NET geliştiricileri bu alanı yakından takip etmek isteyecekler.

Son Düşünceler

C#'ta ayrımcı birlikleri kullanmak, yerel destek olmadan bile, IronPDF uygulamalarınızda mantığı nasıl yapılandırır ve temsil ettiğinizde önemli ölçüde iyileştirebilir. Kayıtlarla, anahtar kelime ifadeleriyle ve temel sınıflarla işleyerek, kod tabanınızı daha okunabilir, sürdürülebilir ve hatalara karşı dayanıklı hale getireceksiniz—aynı zamanda PDF ile ilgili görevleri ele almanın daha beyan edici ve ifade edici bir yolunu açtığınız için.

Modern, esnek .NET uygulamaları oluşturuyorsanız, bu desen mühendislik araç takımınızda bir zorunluluk.