C# 記錄（對於開發者的運行原理）

Record 聲明

聲明一個記錄是很簡單的。 您可以使用 record 關鍵字後接類型（class 或 struct）和記錄的名稱來定義一個記錄。 例如，可以聲明一個簡單的人員記錄如下：

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

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

此聲明包括 FirstName 和 LastName 的位置參數，在底層為這些屬性生成公共屬性和主構造函數。

不可變 Record Struct

不可變的 record struct 的聲明方式與 record class 類似，但使用 record struct 語法。 它結合了記錄的不可變性和基於值的比較，並具備值類型的性能優勢：

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

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

創建和比較記錄

請考慮以下創建兩個人員記錄實例的例子：

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

儘管 person1 和 person2 是兩個不同的實例，但基於它們的屬性值被認為是相等的，展示了基於值的相等性。 這是與引用類型默認行為的重大不同，後者專注於引用相等性。

不可變屬性

根據設計，記錄屬性是不可變的。 這意味著您無法在創建記錄實例後更改其屬性值。

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

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

記錄的繼承

記錄支持繼承，使您能夠創建數據模型的層次結構。 以下是如何擴展基礎記錄：

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

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

這個 Employee 記錄擴展了 Person，添加了額外的 Department 屬性。

無損變更

記錄提供了一種內置方法，讓您可以從現有的記錄實例創建一個新記錄實例，同時修改一些屬性，這被稱為無損變更。

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

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

內置格式化

記錄自帶格式化功能，以便於調試和記錄，並自動提供其屬性字符串表示。

Console.WriteLine(person1);

Console.WriteLine(person1);

如何安裝 IronPDF Library

安裝 IronPDF 非常簡單，可以在 Visual Studio 的 NuGet Package Manager 中完成。 請按以下步驟操作：

1. 在 Visual Studio 中，導航到 Solution Explorer，右鍵單擊 References，然後選擇 Manage NuGet Packages。
2. 在 NuGet Package Manager 中，選擇 Browse 並搜尋 "IronPdf"。
3. 找到 IronPDF 套件並點擊 Install。

或者，您可以使用以下命令在包管理器控制台中安裝它：

Install-Package IronPdf

範例：使用 C# Record 與 IronPDF

讓我們考慮一個實用的例子，我們使用一個 C# 記錄來保存數據，然後用 IronPDF 製作一個 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");
    }
}

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

此範例創建了一個簡單的 Person 記錄，然後使用 IronPDF 生成一個顯示此人姓名的 PDF 文件。 它展示了 C# 記錄如何無縫集成到 .NET 應用的 PDF 生成中。

IronPDF 授權

IronPDF 是一款商業產品，提供針對不同需求的各種授權，包括個人和商業選擇。 每次購買都附帶一次性授權以及 30 天退款保證。 在購買授權之前探索 IronPDF 授權選項。