C# Record (Funktionsweise für Entwickler)

Datensatz-Erklärung

Die Deklaration eines Records ist unkompliziert. Sie können einen Record mit dem Schlüsselwort record gefolgt von dem Typ (Klasse oder Struktur) und dem Namen des Records definieren. Zum Beispiel kann ein einfacher Personen-Record deklariert werden als:

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

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

Diese Deklaration enthält positionale Parameter für Vorname und Nachname, die im Hintergrund öffentliche Eigenschaften und einen Hauptkonstruktor für diese Eigenschaften generieren.

Unveränderliche Datensatzstruktur

Eine unveränderliche Record-Struktur wird ähnlich wie eine Record-Klasse deklariert, jedoch mit der record struct-Syntax. Sie kombiniert die Unveränderlichkeit und wertbasierte Vergleichbarkeit von Records mit den Leistungsmerkmalen eines Werttyps:

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

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

Erstellen und Vergleichen von Datensätzen

Betrachten Sie das folgende Beispiel, bei dem wir zwei Instanzen eines Personen-Records erstellen:

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

Obwohl person1 und person2 zwei unterschiedliche Instanzen sind, werden sie aufgrund ihrer Eigenschaftswerte als gleich angesehen, was die wertbasierte Gleichheit demonstriert. Dies ist ein bedeutender Unterschied zum Standardverhalten von Referenztypen, die sich auf Referenzgleichheit konzentrieren.

Immutable Eigenschaften

Records sind von Design her unveränderlich. Das bedeutet, dass Sie die Eigenschaftswerte einer Record-Instanz nach ihrer Erstellung nicht ändern können.

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

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

Vererbung mit Datensätzen

Records unterstützen Vererbung und ermöglichen es Ihnen, eine Hierarchie von Datenmodellen zu erstellen. So können Sie einen Basis-Record erweitern:

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

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

Dieses Mitarbeiter-Record erweitert Person und fügt die zusätzliche Abteilung-Eigenschaft hinzu.

Nicht-destruktive Mutation

Records bieten eine integrierte Methode, um eine neue Record-Instanz aus einer bestehenden mit einigen geänderten Eigenschaften zu erstellen, bekannt als nicht-destruktive Mutation.

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

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

Eingebaute Formatierung

Records kommen mit integrierter Formatierung für einfacheres Debuggen und Logging, die automatisch eine Zeichenfolgenrepräsentation ihrer Eigenschaften bereitstellt.

Console.WriteLine(person1);

Console.WriteLine(person1);

Wie wird die IronPDF-Bibliothek installiert

Die Installation von IronPDF ist unkompliziert und kann über den NuGet-Package-Manager in Visual Studio durchgeführt werden. Folgen Sie diesen Schritten:

1. Navigieren Sie in Visual Studio zu Lösungsexplorer, klicken Sie mit der rechten Maustaste auf Verweise und wählen Sie NuGet-Pakete verwalten.
2. Wählen Sie im NuGet-Paket-Manager Durchsuchen aus und suchen Sie nach 'IronPdf'.
3. Finden Sie das IronPDF-Paket und klicken Sie auf Installieren.

Alternativ können Sie es mit der folgenden Befehlszeile in der Package Manager Console installieren:

Install-Package IronPdf

Beispiel: Verwendung von C# Record mit IronPDF

Betrachten wir ein praktisches Beispiel, bei dem wir ein C#-Record verwenden, um Daten zu halten, die wir dann zur Erstellung eines PDF-Dokuments mit IronPDF nutzen:

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

Dieses Beispiel erstellt ein einfaches Person-Record und verwendet dann IronPDF, um ein PDF-Dokument zu generieren, das den Namen der Person anzeigt. Es zeigt, wie nahtlos C#-Records in die PDF-Erstellung in .NET-Anwendungen integriert werden können.

IronPDF-Lizenzierung

IronPDF ist ein kommerzielles Produkt, das verschiedene Lizenzen bietet, die auf unterschiedliche Bedürfnisse zugeschnitten sind, einschließlich Einzel- und Geschäftslösungen. Jeder Kauf umfasst eine lebenslange Lizenz und eine 30-tägige Geld-zurück-Garantie. Erkunden Sie IronPDF-Lizenzierungsoptionen, bevor Sie die Lizenz kaufen.