C# 記錄與類別（開發者如何理解它們）

C# 中的類別：基礎知識

類別一直是 C# 中物件導向程式設計的基石，旨在封裝資料和行為。 它們是參考類型，意即具有相同值的兩個類別實體被視為兩個獨立的物件。 在比較兩個類別實例時，這種區別至關重要； 預設的比較是以參考為基礎，而非以價值為基礎。

public class Person
{
    public int Id { get; set; }
    public string FullName { get; set; }
}

public class Person
{
    public int Id { get; set; }
    public string FullName { get; set; }
}

在上面的範例中，Person 是一個具有 Id 和 FullName 屬性的類別。 即使兩個 Person 實例具有相同的 Id 和 FullName 值，它們在預設情況下也不會被視為相等，因為它們在記憶體中是兩個不同的引用。

C# 中的記錄：不可變的資料結構

記錄類型在 C# 中引入，是一種較新的新增功能，旨在簡化不可變資料結構的建立，提供傳統類別結構的強大替代方案。 與類別不同，記錄提供基於值的相等語意，使其成為資料傳輸物件或只有很少或沒有行為的小型資料結構的理想選擇。

public record Person(int Id, string FullName);

public record Person(int Id, string FullName);

在上例中，記錄定義更為簡潔，減少了模板程式碼。 記錄自動支援非破壞性突變和基於值的比較。 具有相同值的兩個記錄實例被視為相等，與值的語義一致。

實際用途：何時使用 Record 與 Class

在 C# 中選擇類別和記錄或其他資料結構，取決於您建模資料的複雜性以及應用程式所需的行為。 類別是專為複雜的資料結構所設計，可容納行為（方法），並允許所需的可變實體。 另一方面，Records 是簡單資料結構的完美範例，其設計具有不可變的特性和以值為基礎的相等性，是建立後保持不變的資料的理想選擇。

當您的資料結構需要封裝資料和行為，或是需要在資料建立後進行操作時，類別是最理想的選擇。 類的靈活性使類成為大多數傳統物件導向程式設計情境和建立複雜資料結構時的首選。

Records 在資料不變性極其重要的情況下，或是當您處理主要作為資料容器的簡單資料結構時，都會大放異彩。 這些工具內建以數值為基礎的平等性和簡潔的語法，使其成為資料傳輸物件或數值物件的絕佳選擇。

值類型和參考類型

瞭解 C# 中值類型與參考類型的差異至關重要。 類別是參考類型，意即變數持有對記憶體中實際資料的參考。 此特性導致預設的基於參考的平等比較。

記錄（Records）雖然也是參照類型，但透過其內建的基於值的相等性來模擬值語意，使其在比較中的行為有點類似於值類型。

程式碼範例：實作類和記錄。

讓我們來實作一個類別和一個記錄，以突顯語法和行為上的差異。

類別實作：

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }

    public Product(int id, string name)
    {
        Id = id;
        Name = name;
    }
}

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }

    public Product(int id, string name)
    {
        Id = id;
        Name = name;
    }
}

記錄實作：

public record Product(int Id, string Name);

public record Product(int Id, string Name);

請注意記錄實作的簡潔性。 本記錄會自動產生值基相等的構造器、屬性和方法。

瞭解等式：參照與值

C# 中類和記錄類型的核心差異確實在於它們如何處理相等性：

1.類別預設使用參考相等，意即兩個實體若指向相同的記憶體位置，則相等。

2.記錄預設使用值相等，如果兩個實體的屬性具有相同的值，則視為相等。

參考等式範例 (類別)。

public class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
}

var classInstance1 = new Person { Id = 1, Name = "Iron Software" };
var classInstance2 = new Person { Id = 1, Name = "Iron Software" };
Console.WriteLine(classInstance1 == classInstance2); // Outputs: False

public class Person
{
    public int Id { get; set; }
    public string Name { get; set; }
}

var classInstance1 = new Person { Id = 1, Name = "Iron Software" };
var classInstance2 = new Person { Id = 1, Name = "Iron Software" };
Console.WriteLine(classInstance1 == classInstance2); // Outputs: False

具有相同屬性值的兩個類別實體不被視為相等，因為它們在記憶體中是不同的物件。

值相等範例

public record Person(int Id, string Name);

var recordInstance1 = new Person(1, "Iron Software");
var recordInstance2 = new Person(1, "Iron Software");
Console.WriteLine(recordInstance1 == recordInstance2); // Outputs: True

public record Person(int Id, string Name);

var recordInstance1 = new Person(1, "Iron Software");
var recordInstance2 = new Person(1, "Iron Software");
Console.WriteLine(recordInstance1 == recordInstance2); // Outputs: True

預設情況下，具有相同屬性值的記錄的兩個實例會被視為相等。

進階功能：記錄

Records 具備多項進階功能，可滿足對不可變資料結構和基於值的平等性的需求。 with 表達式允許透過複製現有記錄來建立新的記錄實體，但會修改某些屬性，以展示非破壞性的變異。

使用記錄的非破壞性突變：

var originalRecord = new Person(1, "Doe");
var modifiedRecord = originalRecord with { Name = "Iron Developer" };

var originalRecord = new Person(1, "Doe");
var modifiedRecord = originalRecord with { Name = "Iron Developer" };

此功能在處理不可變的資料結構時非常方便，因為它提供了一種"修改"實例而不會改變原始資料的方法。

IronPDF 圖書館簡介

。

IronPDF 是專為 .NET 開發人員設計的 PDF 函式庫，可直接在 .NET 應用程式中建立、編輯和管理 PDF 文件，提供全面的解決方案。 它簡化了 PDF 的產生過程，讓開發人員可以 將 HTML 轉換成 PDF、CSS、JavaScript 及圖片轉換成 PDF。 IronPDF 支援多種 .NET Framework 和專案類型，包括網頁、桌面和主控台應用程式，可跨 Windows、Linux 和 macOS 等多種作業系統。

除 PDF 創建外，IronPDF 還提供編輯 PDF、設定屬性和安全性、處理 PDF 表單以及提取內容等功能。 它旨在滿足那些正在尋找可靠工具將 PDF 功能整合到其 .NET 專案中的開發人員的需求。

using IronPdf;
using System;

public class PdfGenerator
{
    public string HtmlContent { get; set; }

    public PdfGenerator(string htmlContent)
    {
        HtmlContent = htmlContent;
    }

    public void GeneratePdf(string filePath)
    {
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(HtmlContent);
        pdfDocument.SaveAs(filePath);
    }
}

class Program
{
    public static void Main(string[] args)
    {
        License.LicenseKey = "License-Key"; // Set your license key here

        var generator = new PdfGenerator("<h1>Hello, World from Class!</h1>");
        generator.GeneratePdf("ClassExample.pdf");
    }
}

using IronPdf;
using System;

public class PdfGenerator
{
    public string HtmlContent { get; set; }

    public PdfGenerator(string htmlContent)
    {
        HtmlContent = htmlContent;
    }

    public void GeneratePdf(string filePath)
    {
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(HtmlContent);
        pdfDocument.SaveAs(filePath);
    }
}

class Program
{
    public static void Main(string[] args)
    {
        License.LicenseKey = "License-Key"; // Set your license key here

        var generator = new PdfGenerator("<h1>Hello, World from Class!</h1>");
        generator.GeneratePdf("ClassExample.pdf");
    }
}

using IronPdf;
using System;

public record PdfGeneratorRecord(string HtmlContent)
{
    public void GeneratePdf(string filePath)
    {
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(this.HtmlContent);
        pdfDocument.SaveAs(filePath);
    }
}

class Program
{
    public static void Main(string[] args)
    {
        License.LicenseKey = "License-Key"; // Set your license key here

        var recordGenerator = new PdfGeneratorRecord("<h1>Hello, World from Record!</h1>");
        recordGenerator.GeneratePdf("RecordExample.pdf");
    }
}

using IronPdf;
using System;

public record PdfGeneratorRecord(string HtmlContent)
{
    public void GeneratePdf(string filePath)
    {
        var renderer = new ChromePdfRenderer();
        var pdfDocument = renderer.RenderHtmlAsPdf(this.HtmlContent);
        pdfDocument.SaveAs(filePath);
    }
}

class Program
{
    public static void Main(string[] args)
    {
        License.LicenseKey = "License-Key"; // Set your license key here

        var recordGenerator = new PdfGeneratorRecord("<h1>Hello, World from Record!</h1>");
        recordGenerator.GeneratePdf("RecordExample.pdf");
    }
}

結論

。

總而言之，類別提供了傳統的物件導向功能，具有可變狀態和基於參照的相等性，而記錄則提供了現代的方法，以定義基於值的相等性的不可變資料結構。

在使用類別或記錄之間作出選擇時，應以您應用程式的特定需求為導向，並考慮各種因素，例如對不可變性的需求、資料結構的複雜性，以及優先使用的相等性比較方法。 發現 IronPDF 的免費試用版，適合希望將 PDF 功能整合至 .NET 應用程式的使用者，授權費從 $799 起。