Dinamik PDF oluşturma üzerinde çalışan bir .NET geliştiricisi olarak, genellikle belirli türleri temsil etmeniz ve yönetmeniz gerekir — farklı doküman verileri türleri, günlük mesajları, kullanıcı rolleri veya dışa aktarma seçenekleri düşünün. Bu noktada, C# ayrım yapıcı birlik kavramı devreye girer.
C#'ın F# veya Rust gibi doğal ayrım yapıcı birlik desteği olmamasına rağmen, ayrım yapıcı birlikleri etkili bir şekilde simüle edebilirsiniz. Bu blog yazısında, bir C# dilinde ayrım yapıcı birlik türünün nasıl tanımlanacağını ve kullanılacağını inceleyeceğiz, IronPDF ile gerçek dünya PDF işlemlerine nasıl uygulanacağını göstereceğiz ve bu desenin sağladığı faydaları keşfedeceğiz — özellikle desen eşleştirme ile birleştirildiğinde.
Ayrım yapıcı birlikler, aynı zamanda etiketli birlikler veya yapılar türleri olarak da bilinir, bir değişkenin, her biri benzersiz bir durum tanımlayıcı ile ilişkili sınırlı bir dizi olası seçenekten bir değer tutmasına izin verir.
F# gibi diğer dillerde, bunları birlik anahtar kelimesi kullanarak tanımlayabilirsiniz. C# bu özelliği doğal olarak sağlamasa da, geliştiriciler kayıtlar, sınıflar ve anahtar ifadeler gibi akıllı kombinasyonlar kullanarak bunları taklit edebilirler.
Ö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 MustOverride ReadOnly Property PdfAction() As record
public record GenerateReport(String ReportName) : PdfAction
public record LogError(String Message) : PdfAction
public record ExportToExcel(String FilePath) : PdfActionYukarıdaki her kayıt, birliğin tek bir durumunu temsil eder. Temel PdfAction türü ayırt edicidir.
IronPDF kullanarak bir PDF rapor oluşturucu geliştiriyor olduğunuzu ve bir kullanıcının girdilerine bağlı olarak farklı işlemler gerçekleştirmeniz gerektiğini hayal edin — belki bir PDF oluşturmak, bir hatayı günlüğe kaydetmek veya verileri dışa aktarmak.
C#'da ayrımcı birlikleri kullanmak, bu opsiyon türlerini temiz bir şekilde temsil etmenizi sağlar, bu da derleme zamanı güvenliği, daha az hata ve daha net bir mantıkla sonuçlanır.
IronPDF ile nasıl kullanabileceğinize dair bir örnek:
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 SubBu yaklaşım, kodunuzu düzenli ve sağlam tutar ve geliştiren kişilerin tüm olası seçenekleri tek bir konumda anlamalarını kolaylaştırır.
C# birlik anahtar kelimesine sahip olmasa da, ayrım yapıcı birlikleri simüle edebilirsiniz:
Eğer performans ve bellek düzeni önemliyse — örneğin yüksek geçişli PDF günlüğü gibi — yapı ayrım yapıcı birliklerini dikkatli bir şekilde kullanmayı düşünebilirsiniz:
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 StructureNot: Özellikle anahtar ifadelerine dayanırken, yapılarla bazı desen eşleştirme avantajlarını kaybedebilirsiniz.
Bu yazılım mühendisliği desenini benimsemenin birkaç önemli avantajı vardır:
IronPDF ile birleştirildiğinde, kullanıcı girdilerini, işleme mantığını yönetmeyi veya farklı değer hatları ile dinamik şablonlar oluşturmayı kolaylaştırır.
Bu desenin üstün olduğu bazı pratik senaryolar:
Diyelim ki UI olaylarını yakalıyorsunuz ve bunları IronPDF görevlerine ayrım yapıcı birliklerle 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 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 size açık mantıkla olayları temsil etmenize olanak tanır ve halka açık obje türlerine ve aşırı dinamik işlemlere olan bağımlılığı azaltır.
C#'ta yerel ayrım yapıcı birlik desteği ekleme önerisi zaten var, özellikle daha ifade edici tür sistemlerine olan artan taleple birlikte. Henüz birliğe gerçek bir anahtar kelime eklenmemiş olmasına rağmen, C# evrimleşmeye devam ediyor — kayıtlar, desen eşleştirme ve anahtar ifadeleri gibi özellikleri tam ayrım yapıcı birlik işlevselliğine daha yaklaştırıyor.
.NET geliştiricileri modern, fonksiyonel dostu dil yapıları ile ilgilenirse bu alanı yakından izlemek isteyeceklerdir.
Yerel destek olmadan bile, C#'ta ayrım yapıcı birlikleri kullanmak,IronPDF uygulamalarındaki mantığı nasıl yapılandırdığınızı ve temsil ettiğinizi önemli ölçüde iyileştirebilir. Kayıtlar, anahtar ifadeleri ve temel sınıflardan faydalanarak 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 almak için daha beyan edici ve ifade edici bir yol açacaksınız.
Eğer modern, esnek .NET uygulamaları inşa eden bir yazılım mühendisi iseniz, bu desen alet çantanızda olmazsa olmazdır.
C# PDF oluşturma işinizi bir sonraki seviyeye taşımaya hazır mısınız? IronPDF'yi indirip ücretsiz bir deneme ile başlayın. İster HTML'den belgeler oluşturuyor, günlük ihraçları yapıyor, ister ayrım yapıcı birlikleri kullanarak raporlar otomatikleştiriyor olun — IronPDF uygulamaya hak ettiği güç ve performansı sağlar.
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.
IronPDF, IRONSUITE'in bir parçasıdır
Ofis belgeleriniz için 10 .NET API ürünü
PDF'nizin HTML gibi görünmesine ihtiyaç duyduğunuzda, hızlı.
