.NET 幫助

C# 記錄（它如何對開發人員起作用）

發佈 2024年4月3日

C# 記錄是一個強大的功能，引入以簡化不可變數據模型的創建，並通過減少模板代碼來提升編碼體驗。本教程旨在簡化C#中記錄的概念，為初學者提供指導，帶您了解其語法、用法和優勢。

無論您是處理數據傳輸對象、配置，還是僅僅需要一種高效的方法來表示數據，C# 記錄都提供了一種簡潔且對開發者友好的方法。我們還將討論IronPDF稍後在本文中。

什麼是 C# 記錄？

在 C# 中，record 是一種引用類型，提供了一種簡化的語法來定義不可變的數據模型。與傳統的類別定義不同，記錄強調基於值的相等性而非引用相等性。這意味著，若它們的屬性值相同，兩個記錄實例就被認為是相等的，而不僅僅是因為它們在記憶體中指向相同的物件位置。

記錄類型：類別和結構體

在C#中，主要有兩種類型的記錄：

Record 類別：預設的記錄型別，是一種引用型別。
Record struct：為需要值類型的情境而引入，這些結構默認是不可變的，並提供類似於記錄類的基於值的比較。

記錄聲明

宣告記錄很簡單。您可以使用 record 關鍵字後接類型來定義記錄(類別或結構)和記錄的名稱。例如，可以將簡單的個人記錄聲明為：

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)

VB C#

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

記錄的不可變特性

記錄被設計為不可變的，這意味著一旦記錄實例被創建，其屬性值就無法改變。這種不變性在創建可預測和執行緒安全的應用程序中特別重要，尤其是在處理並發操作時。

不可變紀錄結構體

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

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)

VB C#

處理記錄

記錄簡化了資料驅動類型的創建和使用。它們支援繼承，允許非破壞性變更，並提供內建的格式化功能以便於調試。讓我們通過範例來探索這些功能。

創建和比較記錄

考慮以下範例，我們創建了兩個人的記錄實例：

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

VB C#

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

不可變屬性

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

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

VB C#

記錄的繼承

記錄支援繼承，允許您創建數據模型的層次結構。以下是如何擴展基本記錄的方法：

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)

VB C#

此Employee記錄擴展了Person，並增加了額外的Department屬性。

進階記錄功能

非破壞性變異

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

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

VB C#

內建格式化

記錄具有內建格式，以便於除錯和日誌記錄，並自動提供其屬性的字串表示。

Console.WriteLine(person1);

Console.WriteLine(person1);

Console.WriteLine(person1)

VB C#

使用 C# 記錄的優勢

簡化語法：記錄減少了樣板代碼的需求，使您的模型更簡潔且易於閱讀。
不可變資料模型：記錄的不可變性有助於創建線程安全的應用程式。
基於值的相等性：記錄使用基於值的相等性而非引用相等性，非常適合以資料為中心的類型。
支持繼承：記錄可以繼承自其他記錄，允許代碼重用和層級數據模型。

IronPDF 介紹：C# PDF 函式庫

C# 記錄（這是如何為開發人員工作的）：圖 1

IronPDF 概述是一個專為 .NET 開發人員設計的 PDF 庫，用於在 C# 應用程式中生成、編輯和操作 PDF 文件。 IronPDF 支援渲染從 HTML 內容生成 PDF 文件、CSS、圖片和 JavaScript。

其核心功能在於從網頁內容創建PDF文件，提供將HTML字符串、網址和ASPX網頁表單轉換為PDF文件的精簡方法。 IronPDF 在多種應用程式類型中高效運行，包括表單應用程式、伺服器應用程式和網路應用程式。

如何安裝IronPDF庫

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

在 Visual Studio 中，導航到方案總管，右鍵單擊引用，然後選擇管理 NuGet 套件。
在 NuGet 套件管理器中，選擇「瀏覽」並搜尋「IronPdf」。
找到 IronPDF 套件並點擊安裝。
或者，您可以使用以下命令在套件管理器控制台中安裝它：

Install-Package IronPdf

範例：使用 C# 記錄與 IronPDF

讓我們考慮一個實際範例，使用 C# 記錄來保存數據，然後使用 IronPDF 生成 PDF 文件：

public record Person(string FirstName, string LastName);
class Program
{
    static void Main(string [] args)
    {
        var person = new Person("Iron", "Developer");
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf($"<h1>Person Record</h1><p>Name: {person.FirstName} {person.LastName}</p>");
        pdf.SaveAs("PersonRecord.pdf");
    }
}

public record Person(string FirstName, string LastName);
class Program
{
    static void Main(string [] args)
    {
        var person = new Person("Iron", "Developer");
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf($"<h1>Person Record</h1><p>Name: {person.FirstName} {person.LastName}</p>");
        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)
		Dim person As New Person("Iron", "Developer")
		Dim renderer = New ChromePdfRenderer()
		Dim pdf = renderer.RenderHtmlAsPdf($"<h1>Person Record</h1><p>Name: {person.FirstName} {person.LastName}</p>")
		pdf.SaveAs("PersonRecord.pdf")
	End Sub
End Class

VB C#

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

C# 記錄 (對開發人員的運作方式)：圖 3