Trabajar con archivos PDF en C# a menudo implica manejar diferentes tipos de documentos, acciones o fuentes de datos. Tradicionalmente, los desarrolladores podrían depender de largas cadenas if-else o declaraciones switch anidadas para gestionar varios valores de entrada y tipos o decisiones de salida. Pero con características modernas de C# como switch pattern matching, tu código puede volverse mucho más elegante, legible y mantenible.
Cuando se combina con una poderosa biblioteca PDF como IronPDF, el switch pattern matching te permite construir lógica más inteligente y limpia para el procesamiento de documentos. En este artículo, exploraremos cómo usar las características avanzadas de pattern matching de C#—como patrones de tipo, patrones de propiedad y patrones relacionales—junto con IronPDF para optimizar tus flujos de trabajo de generación de PDF.
Switch pattern matching es una característica introducida en C# 7 y continuamente mejorada en versiones posteriores. A diferencia de las declaraciones switch tradicionales que solo coinciden con valores constantes, el pattern matching te permite evaluar tipos, propiedades y condiciones dentro de una sola expresión. El siguiente ejemplo muestra cómo funciona esta característica.
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 SelectEste código utiliza patrones de tipo, operadores relacionales y un patrón constante nulo para manejar múltiples casos de manera concisa. Esta técnica mejora significativamente la legibilidad del código con una sintaxis más concisa y soporta lógica más compleja.
IronPDF es un poderoso componente .NET para generar y manipular PDFs a partir de HTML, imágenes o texto sin formato. Muchos casos de uso del mundo real implican procesar diferentes patrones de entrada: algunos documentos podrían originarse en URLs, otros en cadenas HTML, y otros en cargas de archivos.
En lugar de probar expresiones con torpes condiciones if, switch pattern matching te permite soportar lógica basada en patrones de manera eficiente. Te permite definir cómo responde tu aplicación a diferentes tipos de objetos, constantes especificadas o incluso expresiones booleanas, utilizando la expresión de entrada misma para impulsar el flujo de trabajo.
En el ejemplo anterior vimos cómo luce la sintaxis básica, pero ahora veamos cómo funciona en acción. Los siguientes ejemplos de código son algunas tareas del mundo real con PDF que se benefician al combinar IronPDF con el pattern matching de C#.
Supongamos que tu método acepta varios formatos de entrada: HTML, un Uri o un archivo .html local. Usando patrones de tipo, patrones de propiedad y patrones nulos, puedes distinguir estos casos sin esfuerzo.
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 ClassAquí, el patrón de propiedad (FileInfo { Extension: ".html" }) y el patrón constante nulo (case null) hacen que la lógica sea más expresiva y robusta.
Supongamos que estás utilizando un registro PdfRequest que incluye una cadena de formato. Puedes aplicar patrones posicionales, patrones de declaración y constantes de cadena para personalizar el formato de PDF.
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 ClassEste uso demuestra cómo la expresión coincide con la propiedad correspondiente dentro del registro, siguiendo patrones lógicos basados en valores esperados.
Usa patrones var y not para manejar roles de usuario mientras evitas estados nulos o inesperados.
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 IfEsta estructura mejora la seguridad y la legibilidad del código, mientras aprovecha las declaraciones de variables temporales como var email. La siguiente imagen muestra los diferentes documentos PDF creados basados en diferentes valores de entrada.
¿Necesitas generar diferentes PDFs dependiendo de los niveles de usuario? Intenta usar dos patrones relacionales para probar si la entrada cae dentro de un rango determinado.
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 ClassLos operadores relacionales y las expresiones booleanas mantienen el código conciso y expresivo.
Switch pattern matching es más que una mejora sintáctica, es un poderoso paradigma para escribir código más seguro y expresivo. Combinado con las capacidades flexibles de renderización de IronPDF, puedes crear canales de generación de documentos más inteligentes y escalables con un mínimo de código.
Ya sea que estés construyendo un generador de informes, un visor de documentos o un sistema de plantillas dinámicas, intenta agregar pattern matching a tu implementación de IronPDF. Pronto verás los beneficios en claridad, control y mantenibilidad.
Descarga la prueba gratuita para probar las potentes características de IronPDF por ti mismo antes de comprar una licencia.
Jacob Mellor es Director de Tecnología de Iron Software y un ingeniero visionario pionero en la tecnología C# PDF. Como desarrollador original de la base de código principal de Iron Software, ha dado forma a la arquitectura de productos de la empresa desde su creación, transformándola, junto con el director ejecutivo Cameron Rimington, en una empresa de más de 50 personas que presta servicios a la NASA, Tesla y organismos gubernamentales de todo el mundo.
IronPDF es parte de IRONSUITE
10 productos API .NET para tus documentos de oficina
Cuando necesitas que tu PDF se parezca al HTML, rápido.
