C# Record (Cómo Funciona para Desarrolladores)

Declaración de registro

Declarar un record es sencillo. Puede definir un record usando la palabra clave record seguida por el tipo (clase o struct) y el nombre del record. Por ejemplo, un record simple de persona puede declararse como:

public record class Person(string FirstName, string LastName);

public record class Person(string FirstName, string LastName);

'INSTANT VB TODO TASK: C# 'records' are not converted by Instant VB:
'public record class Person(string FirstName, string LastName)

Esta declaración incluye parámetros posicionales para FirstName y LastName, que, internamente, generan propiedades públicas y un constructor primario para estas propiedades.

Estructura de registro inmutable

Un struct record inmutable se declara de manera similar a una clase record pero utilizando la sintaxis record struct. Combina la inmutabilidad y la comparación basada en valores de los records con los beneficios de rendimiento de un tipo de valor:

public readonly record struct ImmutablePerson(string FirstName, string LastName);

public readonly record struct ImmutablePerson(string FirstName, string LastName);

'INSTANT VB TODO TASK: C# 'records' are not converted by Instant VB:
'public readonly record struct ImmutablePerson(string FirstName, string LastName)

Creación y comparación de registros

Considera el siguiente ejemplo donde creamos dos instancias de un record de persona:

var person1 = new Person("Iron", "Software");
var person2 = new Person("Iron", "Software");
Console.WriteLine(person1 == person2); // Output: True

var person1 = new Person("Iron", "Software");
var person2 = new Person("Iron", "Software");
Console.WriteLine(person1 == person2); // Output: True

Dim person1 = New Person("Iron", "Software")
Dim person2 = New Person("Iron", "Software")
Console.WriteLine(person1 = person2) ' Output: True

A pesar de que persona1 y persona2 son dos instancias distintas, se consideran iguales basándose en sus valores de propiedad, demostrando la igualdad basada en valores. Esto representa una desviación significativa del comportamiento predeterminado de los tipos de referencia, que se centra en la igualdad de referencia.

Propiedades inmutables

Por diseño, las propiedades de los records son inmutables. Esto significa que no puede cambiar los valores de propiedad de una instancia de record después de que ha sido creada.

// This will result in a compilation error
// person1.FirstName = "Jane";

// This will result in a compilation error
// person1.FirstName = "Jane";

' This will result in a compilation error
' person1.FirstName = "Jane";

Herencia con registros

Los records soportan la herencia, permitiéndote crear una jerarquía de modelos de datos. Aquí te mostramos cómo puedes extender un record base:

public record Employee(string FirstName, string LastName, string Department) : Person(FirstName, LastName);

public record Employee(string FirstName, string LastName, string Department) : Person(FirstName, LastName);

'INSTANT VB TODO TASK: C# 'records' are not converted by Instant VB:
'public record Employee(string FirstName, string LastName, string Department) : Person(FirstName, LastName)

Este record Empleado extiende Persona, añadiendo la propiedad adicional Departamento.

Mutación no destructiva

Los records proporcionan un método incorporado para crear una nueva instancia de record a partir de una existente con algunas propiedades modificadas, conocido como mutación no destructiva.

var updatedPerson = person1 with { FirstName = "Jane" };

var updatedPerson = person1 with { FirstName = "Jane" };

'INSTANT VB TODO TASK: C# 'with expressions' are not converted by Instant VB:
'var updatedPerson = person1 with { FirstName = "Jane" }

Formato incorporado

Los records vienen con un formateo incorporado para facilitar la depuración y el registro, proporcionando automáticamente una representación de cadena de sus propiedades.

Console.WriteLine(person1);

Console.WriteLine(person1);

Console.WriteLine(person1)

Cómo instalar la biblioteca IronPDF

Instalar IronPDF es sencillo y se puede realizar a través del Administrador de Paquetes NuGet en Visual Studio. Siga estos pasos:

1. En Visual Studio, navegue al Explorador de Soluciones, haga clic derecho en Referencias y seleccione Administrar Paquetes NuGet.
2. En el Administrador de Paquetes NuGet, seleccione Examinar y busque "IronPDF".
3. Encuentre el paquete de IronPDF y haga clic en Instalar.

Alternativamente, puede instalarlo usando la Consola del Administrador de Paquetes con el comando:

Install-Package IronPdf

Ejemplo: Uso de C# Record con IronPDF

Consideremos un ejemplo práctico donde usamos un record de C# para mantener datos que luego usamos para generar un documento PDF con IronPDF:

public record Person(string FirstName, string LastName);

class Program
{
    static void Main(string[] args)
    {
        // Create an instance of the Person record.
        var person = new Person("Iron", "Developer");

        // Initialize a new renderer object for generating PDF files using Chrome's rendering engine.
        var renderer = new IronPdf.Rendering.ChromePdfRenderer();

        // Render an HTML string as a PDF document.
        var pdf = renderer.RenderHtmlAsPdf($"<h1>Person Record</h1><p>Name: {person.FirstName} {person.LastName}</p>");

        // Save the PDF to the specified location.
        pdf.SaveAs("PersonRecord.pdf");
    }
}

public record Person(string FirstName, string LastName);

class Program
{
    static void Main(string[] args)
    {
        // Create an instance of the Person record.
        var person = new Person("Iron", "Developer");

        // Initialize a new renderer object for generating PDF files using Chrome's rendering engine.
        var renderer = new IronPdf.Rendering.ChromePdfRenderer();

        // Render an HTML string as a PDF document.
        var pdf = renderer.RenderHtmlAsPdf($"<h1>Person Record</h1><p>Name: {person.FirstName} {person.LastName}</p>");

        // Save the PDF to the specified location.
        pdf.SaveAs("PersonRecord.pdf");
    }
}

'INSTANT VB TODO TASK: C# 'records' are not converted by Instant VB:
'public record Person(string FirstName, string LastName)

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		' Create an instance of the Person record.
		Dim person As New Person("Iron", "Developer")

		' Initialize a new renderer object for generating PDF files using Chrome's rendering engine.
		Dim renderer = New IronPdf.Rendering.ChromePdfRenderer()

		' Render an HTML string as a PDF document.
		Dim pdf = renderer.RenderHtmlAsPdf($"<h1>Person Record</h1><p>Name: {person.FirstName} {person.LastName}</p>")

		' Save the PDF to the specified location.
		pdf.SaveAs("PersonRecord.pdf")
	End Sub
End Class

Este ejemplo crea un simple record Persona y luego utiliza IronPDF para generar un documento PDF que muestra el nombre de la persona. Demuestra cómo los records de C# pueden integrarse sin problemas con la generación de PDF en aplicaciones .NET.

Licencias de IronPDF

IronPDF es un producto comercial que ofrece varias licencias adaptadas a diferentes necesidades, incluyendo opciones individuales y comerciales. Cada compra viene con una licencia de por vida y una garantía de devolución de dinero de 30 días. Explora las Opciones de Licencia de IronPDF antes de comprar la licencia.