C# Record（开发者如何使用）

记录声明

声明记录非常简单。 您可以使用 record 关键字定义记录，后跟类型（类或结构体）和记录的名称。 例如，可以声明一个简单的人员记录为：

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

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

此声明包括 FirstName 和 LastName 的位置参数，实质上为这些属性生成公共属性和主构造函数。

不可变记录结构体

不可变记录结构体的声明类似于记录类，但使用 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);

此 雇员 记录扩展了 人员，添加了额外的 部门 属性。

无损变更

记录提供了一种内置方法，用于从现有记录实例创建带有某些属性修改的新记录实例，称为无损变更。

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 包并点击安装。

或者，您可以使用包管理器控制台通过以下命令安装：

Install-Package IronPdf

示例：将 C# 记录与 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");
    }
}

此示例创建了一个简单的 人员 记录，然后使用 IronPDF 生成显示人名的 PDF 文档。 它展示了 C# 记录如何无缝地与 .NET 应用程序中的 PDF 生成集成。

IronPDF许可

IronPDF 是一款商业产品，提供多种根据不同需求量身定制的许可证，包括个人和商业选项。 每次购买都附带终身许可证和 30 天退款保证。 探索 IronPDF 许可证选项 在购买许可证之前。