Gravação em C# (Como funciona para desenvolvedores)

Declaração de Registro

Declarar um registro é simples. Você pode definir um registro usando a palavra-chave record seguida pelo tipo (classe ou estrutura) e o nome do registro. Por exemplo, um registro simples de pessoa pode ser declarado 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 declaração inclui parâmetros posicionais para FirstName e LastName , que, internamente, geram propriedades públicas e um construtor primário para essas propriedades.

Estrutura de registro imutável

Uma estrutura de registro imutável é declarada de forma semelhante a uma classe de registro, mas usando a sintaxe de estrutura de registro . Ele combina a imutabilidade e a comparação de registros baseada em valores com os benefícios de desempenho de um 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)

Criação e comparação de registros

Considere o seguinte exemplo, onde criamos duas instâncias de um registro de pessoa:

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

Apesar de a pessoa 1 e a pessoa 2 serem duas instâncias distintas, elas são consideradas iguais com base no valor de suas propriedades, demonstrando igualdade baseada em valores. Isso representa um afastamento significativo do comportamento padrão dos tipos de referência, que se concentra na igualdade de referência.

Propriedades Imutáveis

Por definição, as propriedades dos registros são imutáveis. Isso significa que você não pode alterar os valores das propriedades de uma instância de registro depois que ela tiver sido criada.

// 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";

Herança com Registros

Os registros suportam herança, permitindo que você crie uma hierarquia de modelos de dados. Eis como você pode estender um registro 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 registro de Funcionário amplia o registro de Pessoa , adicionando a propriedade adicional Departamento .

Mutação não destrutiva

Os registros fornecem um método integrado para criar uma nova instância de registro a partir de uma existente com algumas propriedades modificadas, conhecido como mutação não destrutiva.

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" }

Formatação integrada

Os registros vêm com formatação integrada para facilitar a depuração e o registro em log, fornecendo automaticamente uma representação em formato de string de suas propriedades.

Console.WriteLine(person1);

Console.WriteLine(person1);

Console.WriteLine(person1)

Como instalar a biblioteca IronPDF

A instalação do IronPDF é simples e pode ser feita através do Gerenciador de Pacotes NuGet no Visual Studio. Siga estes passos:

1. No Visual Studio, acesse o Solution Explorer, clique com o botão direito do mouse em References e selecione Manage NuGet Packages.
2. No Gerenciador de Pacotes NuGet , selecione Procurar e pesquise por "IronPDF".
3. Localize o pacote IronPDF e clique em Instalar.

Alternativamente, você pode instalá-lo usando o Console do Gerenciador de Pacotes com o comando:

Install-Package IronPdf

Exemplo: Usando C# Record com IronPDF

Vamos considerar um exemplo prático onde usamos um registro C# para armazenar dados que depois utilizamos para gerar um documento PDF com o 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 exemplo cria um registro simples de Pessoa e, em seguida, usa o IronPDF para gerar um documento PDF exibindo o nome da pessoa. Este vídeo demonstra como os registros em C# podem ser integrados perfeitamente à geração de PDFs em aplicações .NET .

Licenciamento IronPDF

O IronPDF é um produto comercial que oferece diversas licenças adaptadas a diferentes necessidades, incluindo opções individuais e comerciais. Cada compra inclui uma licença vitalícia e uma garantia de reembolso de 30 dias. Explore as opções de licenciamento do IronPDF antes de adquirir a licença.