C#'ta PDF dosyalarıyla çalışmak, genellikle farklı belge türlerini, eylemleri veya veri kaynaklarını ele almayı içerir. Geleneksel olarak, geliştiriciler çeşitli giriş değerlerini ve türlerini veya çıktı kararlarını yönetmek için uzun if-else zincirlerine veya birbirine geçmiş switch ifadelerine güvenebilirlerdi. Ancak C#'ın switch desen eşleştirmesi gibi modern özellikleri sayesinde kodunuz çok daha nazik, okunabilir ve sürdürülebilir hale gelebilir.
Güçlü bir PDF kütüphanesi olan IronPDF ile birleştirildiğinde, switch desen eşleştirme, belge işleme için daha akıllı, daha temiz mantık oluşturmanızı sağlar. Bu makalede, C#'ın ileri desen eşleştirme özelliklerini — tür desenleri, özellik desenleri ve ilişkisel desenler gibi — IronPDF ile birlikte PDF oluşturma iş akışlarınızı nasıl düzene sokacağınızı keşfedeceğiz.
Switch desen eşleştirme, C# 7'de tanıtılan ve sonraki sürümlerde sürekli iyileştirilen bir özelliktir. Sadece sabit değerleri eşleştiren geleneksel switch ifadelerinin aksine, desen eşleştirme, türleri, özellikleri ve koşulları tek bir ifade içinde değerlendirmenize olanak tanır. Aşağıdaki örnek, bu özelliğin nasıl çalıştığını göstermektedir.
switch (input)
{
case int i when i > 0:
Console.WriteLine("Positive integer");
break;
case string s:
Console.WriteLine($"It's a string: {s}");
break;
default:
Console.WriteLine("Unknown type");
break;
}Select Case input
'INSTANT VB TODO TASK: The following 'case' pattern variable is not converted by Instant VB:
'ORIGINAL LINE: case int i when i > 0:
Case Integer i [when] i > 0
Console.WriteLine("Positive integer")
'INSTANT VB TODO TASK: The following 'case' pattern variable is not converted by Instant VB:
'ORIGINAL LINE: case string s:
Case String s
Console.WriteLine($"It's a string: {s}")
Case Else
Console.WriteLine("Unknown type")
End SelectBu kod, tür desenlerini, ilişkisel operatörleri ve bir boş sabit desenini kullanarak birden fazla durumu özlü bir şekilde ele alır. Bu teknik, daha öz sözdizimi ile kodun okunabilirliğini önemli ölçüde artırır ve daha karmaşık mantığı destekler.
IronPDF, HTML, resimler veya ham metinden PDF'ler oluşturmak ve manipüle etmek için güçlü bir .NET bileşenidir. Birçok gerçek dünya kullanım durumu, farklı giriş desenlerinin işlenmesini içerir: bazı belgeler URL'lerden kaynaklanabilir, diğerleri HTML dizgilerinden ve başka belgeler dosya yüklemelerinden.
Karmaşık koşullar altında ifadeleri test etmenin yerine, switch desen eşleştirme desen tabanlı mantığı verimli bir şekilde desteklemenize olanak tanır. Uygulamanızın farklı nesne türlerine, belirtilen sabitlere veya hatta Boole ifadelerine nasıl yanıt vereceğini tanımlamanıza izin verir, giriş ifadesini iş akışını yönlendirmek için kullanarak.
Önceki örnekte temel sözdizimine baktık, ancak şimdi bunu uygulamada görelim. Aşağıdaki kod örnekleri, IronPDF ile C# desen eşleştirmenin birleşiminden yararlanan bazı gerçek dünya PDF görevleridir.
Yönteminizin çeşitli giriş formatlarını kabul ettiğini varsayalım: HTML, bir Uri veya yerel bir .html dosyası. Tür desenlerini, özellik desenlerini ve null desenlerini kullanarak bu durumları zahmetsizce ayırt edebilirsiniz.
using System;
using System.IO;
using IronPdf;
class Program
{
static void Main()
{
object input = new Uri("https://example.com"); // Try changing this to: "<html><body>Hello</body></html>" or new FileInfo("sample.html")
var renderer = new ChromePdfRenderer();
PdfDocument pdfDoc = input switch
{
string html when html.StartsWith("<html>") =>
renderer.RenderHtmlAsPdf(html),
Uri url =>
renderer.RenderUrlAsPdf(url.ToString()),
FileInfo { Extension: ".html" } file =>
renderer.RenderHtmlAsPdf(File.ReadAllText(file.FullName)),
null => throw new ArgumentNullException("Input was null."),
_ => throw new ArgumentException("Unsupported input type for PDF conversion.")
};
pdfDoc.SaveAs("example-input-types.pdf");
Console.WriteLine("PDF created: example-input-types.pdf");
}
}Imports System
Imports System.IO
Imports IronPdf
Friend Class Program
Shared Sub Main()
Dim input As Object = New Uri("https://example.com") ' Try changing this to: "<html><body>Hello</body></html>" or new FileInfo("sample.html")
Dim renderer = New ChromePdfRenderer()
'INSTANT VB TODO TASK: The following 'switch expression' was not converted by Instant VB:
' PdfDocument pdfDoc = input switch
' {
' string html when html.StartsWith("<html>") => renderer.RenderHtmlAsPdf(html),
' Uri url =>
' renderer.RenderUrlAsPdf(url.ToString()),
' FileInfo { Extension: ".html" } file =>
' renderer.RenderHtmlAsPdf(File.ReadAllText(file.FullName)),
' null => throw new ArgumentNullException("Input was null."),
' _ => throw new ArgumentException("Unsupported input type for PDF conversion.")
' };
pdfDoc.SaveAs("example-input-types.pdf")
Console.WriteLine("PDF created: example-input-types.pdf")
End Sub
End ClassBurada, özellik deseni (FileInfo { Extension: ".html" }) ve null sabit deseni (case null), mantığı daha ifade edici ve sağlam hale getirir.
PdfRequest kaydında bir format dizgisi içeren bir kaydı kullandığınızı varsayalım. Pozisyonel desenler, deklarasyon desenler ve dizge sabitleri kullanarak PDF biçimlendirmesini özelleştirebilirsiniz.
using System;
using IronPdf;
public record PdfRequest(string Title, string Content, string Format);
class Program
{
static void Main()
{
PdfRequest request = new("My Report", "<h1>Monthly Report</h1><p>Generated by IronPDF.</p>", "A4");
var renderer = new ChromePdfRenderer();
// Use fully qualified enum to avoid IronWord conflict
renderer.RenderingOptions = request switch
{
PdfRequest { Format: "A4" } => new IronPdf.ChromePdfRenderOptions
{
PaperSize = IronPdf.Rendering.PdfPaperSize.A4
},
PdfRequest { Format: "Letter" } => new IronPdf.ChromePdfRenderOptions
{
PaperSize = IronPdf.Rendering.PdfPaperSize.Letter
},
_ => new IronPdf.ChromePdfRenderOptions
{
PaperSize = IronPdf.Rendering.PdfPaperSize.Legal // Fallback
}
};
var pdf = renderer.RenderHtmlAsPdf(request.Content);
pdf.SaveAs("example-formatted.pdf");
Console.WriteLine("PDF created: example-formatted.pdf");
}
}Imports System
Imports IronPdf
'INSTANT VB TODO TASK: C# 'records' are not converted by Instant VB:
'public record PdfRequest(string Title, string Content, string Format)
Friend Class Program
Shared Sub Main()
Dim request As New PdfRequest("My Report", "<h1>Monthly Report</h1><p>Generated by IronPDF.</p>", "A4")
Dim renderer = New ChromePdfRenderer()
' Use fully qualified enum to avoid IronWord conflict
'INSTANT VB TODO TASK: The following 'switch expression' was not converted by Instant VB:
' renderer.RenderingOptions = request switch
' {
' PdfRequest { Format: "A4" } => new IronPdf.ChromePdfRenderOptions
' {
' PaperSize = IronPdf.Rendering.PdfPaperSize.A4
' },
' PdfRequest { Format: "Letter" } => new IronPdf.ChromePdfRenderOptions
' {
' PaperSize = IronPdf.Rendering.PdfPaperSize.Letter
' },
' _ => new IronPdf.ChromePdfRenderOptions
' {
' PaperSize = IronPdf.Rendering.PdfPaperSize.Legal // Fallback
' }
' };
Dim pdf = renderer.RenderHtmlAsPdf(request.Content)
pdf.SaveAs("example-formatted.pdf")
Console.WriteLine("PDF created: example-formatted.pdf")
End Sub
End ClassBu kullanım, ifadenin kaydın içinde karşılık gelen özelliği, beklenen değerlere dayalı mantıksal desenler izleyerek eşleştirdiği şekilde düşünülmüştür.
Kullanıcı rolleriyle başa çıkmak için var desenlerini ve not desenlerini kullanarak null veya beklenmedik durumların önüne geçin.
using System;
using IronPdf;
public abstract record UserRole;
public record Admin(string Email) : UserRole;
public record Viewer(string Email) : UserRole;
public record Guest() : UserRole;
class Program
{
static void Main()
{
UserRole currentUser = new Admin("admin@example.com"); // Try changing to Viewer or Guest
var pdf = currentUser switch
{
Admin { Email: var email } =>
new ChromePdfRenderer().RenderHtmlAsPdf($"<h1>Admin Dashboard</h1><p>Email: {email}</p>"),
Viewer =>
new ChromePdfRenderer().RenderHtmlAsPdf("<h1>Viewer Summary</h1><p>Access limited.</p>"),
Guest =>
new ChromePdfRenderer().RenderHtmlAsPdf("<h1>Guest Mode</h1><p>Please sign in.</p>"),
not null =>
throw new UnauthorizedAccessException("Unknown role type."),
null =>
throw new ArgumentNullException("Role cannot be null.")
};
pdf.SaveAs("example-role.pdf");
Console.WriteLine("PDF created: example-role.pdf");
}
}Imports System
Imports IronPdf
Public MustOverride ReadOnly Property UserRole() As record
public record Admin(String Email) : UserRole
public record Viewer(String Email) : UserRole
public record Guest() : UserRole
Dim Program As class
If True Then
'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
' static void Main()
' {
' UserRole currentUser = New Admin("admin@example.com"); ' Try changing to Viewer or Guest
''INSTANT VB TODO TASK: The following 'switch expression' was not converted by Instant VB:
'' var pdf = currentUser switch
'' {
'' Admin { Email: var email } => new ChromePdfRenderer().RenderHtmlAsPdf($"<h1>Admin Dashboard</h1><p>Email: {email}</p>"),
'' Viewer =>
'' new ChromePdfRenderer().RenderHtmlAsPdf("<h1>Viewer Summary</h1><p>Access limited.</p>"),
'' Guest =>
'' new ChromePdfRenderer().RenderHtmlAsPdf("<h1>Guest Mode</h1><p>Please sign in.</p>"),
'' not null =>
'' throw new UnauthorizedAccessException("Unknown role type."),
'' null =>
'' throw new ArgumentNullException("Role cannot be null.")
'' };
' pdf.SaveAs("example-role.pdf");
' Console.WriteLine("PDF created: example-role.pdf");
' }
End IfBu yapı, geçici değişken bildirimleri gibi var email'e dayalı güvenliği ve kodun okunabilirliğini artırır. Aşağıdaki resim, farklı giriş değerlere dayalı oluşturulan farklı PDF belgelerini göstermektedir.
Kullanıcı seviyelerine bağlı olarak farklı PDF'ler oluşturmanız mı gerekiyor? Girişin belirli bir aralığa girip girmediğini test etmek için iki ilişkisel desen kullanmayı deneyin.
using System;
using IronPdf;
class Program
{
static void Main()
{
int userScore = 85; // Try other values: 45, 70, 101
string message = userScore switch
{
< 60 => "Needs Improvement",
>= 60 and < 80 => "Satisfactory",
>= 80 and <= 100 => "Excellent",
_ => "Invalid score"
};
var html = $"<h1>Score Report</h1><p>Score: {userScore}</p><p>Result: {message}</p>";
var pdf = new ChromePdfRenderer().RenderHtmlAsPdf(html);
pdf.SaveAs("example-score.pdf");
Console.WriteLine("PDF created: example-score.pdf");
}
}Imports System
Imports IronPdf
Friend Class Program
Shared Sub Main()
Dim userScore As Integer = 85 ' Try other values: 45, 70, 101
'INSTANT VB TODO TASK: The following 'switch expression' was not converted by Instant VB:
' string message = userScore switch
' {
' < 60 => "Needs Improvement",
' >= 60 and < 80 => "Satisfactory",
' >= 80 and <= 100 => "Excellent",
' _ => "Invalid score"
' };
Dim html = $"<h1>Score Report</h1><p>Score: {userScore}</p><p>Result: {message}</p>"
Dim pdf = (New ChromePdfRenderer()).RenderHtmlAsPdf(html)
pdf.SaveAs("example-score.pdf")
Console.WriteLine("PDF created: example-score.pdf")
End Sub
End Classİlişkisel operatörler ve boole ifadeleri, kodu özlü ve ifade edici kılar.
Switch desen eşleştirme, sadece sözdizimsel bir gelişme olmaktan öte, daha güvenli, daha ifade edici kod yazmak için güçlü bir paradigmadır. IronPDF'nin esnek render yetenekleriyle birleştiğinde, minimal kod ile daha akıllı ve ölçeklenebilir belge üretim hatları oluşturabilirsiniz.
Bir rapor oluşturucu, belge ön izleyici veya dinamik bir şablon sistemi kuruyorsanız, IronPDF uygulamanıza desen eşleştirme eklemeyi deneyin. Netlik, kontrol ve sürdürülebilirlikteki faydalarını hızlıca göreceksiniz.
Ücretsiz deneme sürümünü indirin ve IronPDF'nin güçlü özelliklerini bir lisans satın almadan önce kendiniz deneyin.
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ı.
