C# Record (jak to działa dla programistów)

Deklaracja rekordu

Deklaracja rekordu jest prosta. Rekord można zdefiniować za pomocą słowa kluczowego record, po którym następuje typ (klasa lub struktura) oraz nazwa rekordu. Na przykład prosty rekord osoby można zadeklarować jako:

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)

Ta deklaracja zawiera parametry pozycyjne dla FirstName i LastName, które w tle generują właściwości publiczne oraz główny konstruktor dla tych właściwości.

Niezmienna struktura rekordów

Niezmienna struktura rekordowa jest deklarowana podobnie jak klasa rekordowa, ale przy użyciu składni struktury rekordowej. Łączy to niezmienność i porównywanie rekordów na podstawie wartości z korzyściami wydajnościowymi typu wartościowego:

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)

Tworzenie i porównywanie rekordów

Rozważmy następujący przykład, w którym tworzymy dwie instancje rekordu osoby:

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

Pomimo że person1 i person2 są dwoma odrębnymi instancjami, są one traktowane jako równe na podstawie wartości ich właściwości, co stanowi przykład równości opartej na wartościach. Jest to znaczące odejście od domyślnego zachowania typów referencyjnych, które koncentruje się na równości referencji.

Właściwości niezmienne

Zgodnie z projektem właściwości rekordów są niezmienne. Oznacza to, że nie można zmieniać wartości właściwości instancji rekordu po jej utworzeniu.

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

Dziedziczenie z rekordami

Rekordy obsługują dziedziczenie, co pozwala tworzyć hierarchię modeli danych. Oto jak można rozszerzyć rekord bazowy:

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)

Ten rekord pracownika rozszerza klasę Person, dodając dodatkową właściwość Department.

Mutacja nieniszcząca

Rekordy zapewniają wbudowaną metodę tworzenia nowej instancji rekordu na podstawie istniejącej, z pewnymi zmodyfikowanymi właściwościami, znaną jako mutacja nieniszcząca.

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

Wbudowane formatowanie

Rekordy posiadają wbudowane formatowanie ułatwiające debugowanie i rejestrowanie, automatycznie zapewniając reprezentację ich właściwości w postaci ciągu znaków.

Console.WriteLine(person1);

Console.WriteLine(person1);

Console.WriteLine(person1)

Jak zainstalować bibliotekę IronPDF

Instalacja IronPDF jest prosta i można ją przeprowadzić za pomocą menedżera pakietów NuGet w Visual Studio. Postępuj zgodnie z poniższymi wskazówkami:

1. W programie Visual Studio przejdź do Eksploratora rozwiązań, kliknij prawym przyciskiem myszy opcję Odwołania i wybierz Zarządzaj pakietami NuGet.
2. W menedżerze pakietów NuGet wybierz opcję Przeglądaj i wyszukaj "IronPdf".
3. Znajdź pakiet IronPDF i kliknij Instaluj.

Alternatywnie można zainstalować go za pomocą konsoli menedżera pakietów, używając polecenia:

Install-Package IronPdf

Przykład: Korzystanie z C# Record z IronPDF

Rozważmy praktyczny przykład, w którym używamy rekordu C# do przechowywania danych, które następnie wykorzystujemy do wygenerowania dokumentu PDF za pomocą 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

W tym przykładzie tworzony jest prosty rekord osoby, a następnie za pomocą IronPDF generowany jest dokument PDF wyświetlający imię i nazwisko tej osoby. Pokazuje, jak płynnie rekordy C# mogą integrować się z generowaniem plików PDF w aplikacjach .NET.

Licencjonowanie IronPDF

IronPDF to produkt komercyjny oferujący różne licencje dostosowane do różnych potrzeb, w tym opcje indywidualne i komercyjne. Każdy zakup obejmuje dożywotnią licencję oraz 30-dniową gwarancję zwrotu pieniędzy. Przed zakupem licencji zapoznaj się z opcjami licencyjnymi IronPDF.