C# 記錄（開發者如何理解其工作原理）

記錄聲明

申報紀錄很簡單。 您可以使用record關鍵字，後跟類型（類別或結構）和記錄名稱來定義記錄。 例如，一個簡單的人員記錄可以聲明為：

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

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

此聲明包含FirstName和LastName的位置參數，這些參數會在底層產生公共屬性以及這些屬性的主建構子。

不可變記錄結構

不可變記錄結構體的聲明方式與記錄類別類似，但使用記錄結構體的語法。 它結合了記錄的不可變性和基於值的比較特性，以及值類型的性能優勢：

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

此員工記錄繼承自 Person記錄，並新增了Department屬性。

非破壞性突變

記錄提供了一種內建方法，可以從現有記錄實例建立新記錄實例，並修改其中的一些屬性，稱為非破壞性修改。

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

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

內建格式化

記錄帶有內建格式，便於調試和日誌記錄，自動提供其屬性的字串表示形式。

Console.WriteLine(person1);

Console.WriteLine(person1);

如何安裝 IronPDF 庫

安裝 IronPDF 非常簡單，可以透過 Visual Studio 中的 NuGet 套件管理器完成。 請依照以下步驟操作：

1. 在 Visual Studio 中，導覽至解決方案資源管理器，右鍵按一下"參考"，然後選擇"管理 NuGet 套件"。
2. 在 NuGet 套件管理員中，選擇"瀏覽"並搜尋"IronPdf"。
3. 找到 IronPDF 軟體包並點選"安裝"。

C# 記錄（開發者如何理解其工作原理）：圖 2

或者，您可以使用軟體包管理器控制台透過以下命令進行安裝：

Install-Package IronPdf

範例：在 IronPDF 中使用 C# Record

讓我們來看一個實際的例子，其中我們使用 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");
    }
}

本範例建立一個簡單的人員記錄，然後使用 IronPDF 產生一個顯示該人員姓名的 PDF 文件。 它展示了 C# 記錄如何與 .NET 應用程式中的 PDF 生成無縫整合。

C# 記錄（開發者如何理解）：圖 3

IronPDF 許可

C# 記錄（開發者如何操作）：圖 4

IronPDF 是一款商業產品，提供各種滿足不同需求的許可證，包括個人版和商業版。 每次購買均附帶終身授權和 30 天退款保證。 購買許可證前，請先了解 IronPDF 的許可選項。