C# Record (Comment ça fonctionne pour les développeurs)

Déclaration de record

Déclarer un record est simple. Vous pouvez définir un record en utilisant le mot clé record suivi du type (classe ou structure) et du nom du record. Par exemple, un simple record de personne peut être déclaré comme suit :

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)

Cette déclaration inclut des paramètres positionnels pour Prenom et Nom, qui, en coulisse, génèrent des propriétés publiques et un constructeur principal pour ces propriétés.

Structure de record immuable

Une structure de record immuable est déclarée de la même manière qu'une classe de record mais en utilisant la syntaxe record struct. Elle combine l'immuabilité et la comparaison basée sur la valeur des records avec les avantages de performance d'un type de valeur :

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)

Création et comparaison des records

Considérez l'exemple suivant où nous créons deux instances d'un record de personne :

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

Bien que personne1 et personne2 soient deux instances distinctes, elles sont considérées comme égales en fonction de leurs valeurs de propriété, illustrant l'égalité basée sur la valeur. Ceci est un écart significatif par rapport au comportement par défaut des types de référence, qui se concentre sur l'égalité de référence.

Propriétés immuables

Par conception, les propriétés des records sont immuables. Cela signifie que vous ne pouvez pas modifier les valeurs de propriété d'une instance de record après sa création.

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

Héritage avec les records

Les records supportent l'héritage, vous permettant de créer une hiérarchie de modèles de données. Voici comment vous pouvez étendre un record de 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)

Ce Employé record étend Personne, ajoutant la propriété supplémentaire Département.

Mutation non-destructive

Les records fournissent une méthode intégrée pour créer une nouvelle instance de record à partir d'une instance existante avec certaines propriétés modifiées, connue sous le nom de mutation non-destructive.

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

Formatage intégré

Les records sont livrés avec un formatage intégré pour un débogage et une journalisation plus faciles, fournissant automatiquement une représentation sous forme de chaîne de leurs propriétés.

Console.WriteLine(person1);

Console.WriteLine(person1);

Console.WriteLine(person1)

Comment installer la bibliothèque IronPDF

Installer IronPDF est simple et peut être accompli via le gestionnaire de packages NuGet dans Visual Studio. Suivez ces étapes :

1. Dans Visual Studio, naviguez vers l'Explorateur de solutions, faites un clic droit sur Références et sélectionnez Gérer les paquets NuGet.
2. Dans le gestionnaire de paquets NuGet, sélectionnez Parcourir et recherchez "IronPdf".
3. Trouvez le paquet IronPDF et cliquez sur Installer.

Alternativement, vous pouvez l'installer en utilisant la console du gestionnaire de paquets avec la commande :

Install-Package IronPdf

Exemple : Utilisation d'un record C# avec IronPDF

Considérons un exemple pratique où nous utilisons un record C# pour contenir des données que nous utilisons ensuite pour générer un document PDF avec 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

Cet exemple crée un simple record Personne et utilise ensuite IronPDF pour générer un document PDF affichant le nom de la personne. Il montre comment les records C# peuvent s'intégrer de manière transparente avec la génération de PDF dans les applications .NET.

Licences IronPDF

IronPDF est un produit commercial offrant diverses licences adaptées à différents besoins, y compris des options individuelles et commerciales. Chaque achat est accompagné d'une licence à vie et d'une garantie de remboursement de 30 jours. Explorez les options de licence IronPDF avant d'acheter la licence.