C# 记录（开发人员如何使用）

C# 记录 是一项功能强大的特性，旨在简化不可变数据模型的创建，并通过减少模板代码来增强编码体验。本教程旨在为初学者简化 C# 中记录的概念，指导您了解记录的语法、用法和优势。

无论您是要处理数据传输对象、配置，还是仅仅需要一种高效的数据表示方式，C# 记录都提供了一种简洁且对开发人员友好的方法。我们还将讨论 IronPDF 在文章的后面。

什么是 C# 记录？

C# 中的记录是一种引用类型，它为定义不可变数据模型提供了一种简化的语法。与传统的类定义不同，记录强调的是基于值的平等而不是引用平等。这意味着，如果两个记录实例的属性值相同，它们就被认为是相等的，而不仅仅是因为它们引用了内存中相同的对象位置。

记录类型：类和结构

C# 中主要有两种记录类型：

• 记录类：默认记录类型，是一种引用类型。
• 记录结构体：为需要值类型的情况而引入，默认情况下不可变，并提供与记录类类似的基于值的比较。

记录声明

声明记录非常简单。您可以使用 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)

该声明包括 FirstName 和 LastName 的位置参数，这些参数会生成公共属性和这些属性的主构造函数。

记录的永恒性

记录被设计为不可变的，这意味着一旦创建了记录实例，其属性值就无法更改。这种不可更改性对于创建可预测和线程安全的应用程序至关重要，尤其是在处理并发操作时。

不可变记录结构

不可变记录结构体的声明方式与记录类类似，但使用记录结构体语法。它结合了记录的不可变性和基于值的比较，以及值类型的性能优势：

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)

使用记录

记录简化了以数据为中心的类型的创建和使用。它们支持继承，允许非破坏性突变，并提供内置格式以便于调试。让我们通过示例来了解这些功能。

创建和比较记录

请看下面的示例，我们创建了一个人记录的两个实例：

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

尽管 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";

有记录的继承

记录支持继承，允许你创建数据模型的层次结构。下面介绍如何扩展基本记录：

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)

该员工记录扩展了个人，增加了部门属性。

高级记录功能

非破坏性突变

记录提供了一种内置方法，用于从修改了某些属性的现有记录实例创建新的记录实例，这种方法被称为非破坏性突变。

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

内置格式化

为方便调试和记录，记录带有内置格式，可自动提供其属性的字符串表示。

Console.WriteLine(person1);

Console.WriteLine(person1);

Console.WriteLine(person1)

使用 C# 记录的优势

• 简化语法：记录减少了对模板代码的需求，使您的模型更加简洁易读。
• 不可变的数据模型：记录的不可变性有助于创建线程安全的应用程序。
• 基于值的等价：记录使用基于值的平等而不是引用平等，非常适合以数据为中心的类型。
• 支持继承：记录可以从其他记录继承，从而实现代码重用和分层数据模型。

IronPDF 简介：PDF 库

IronPDF IronPDF 是专为 .NET 开发人员设计的 PDF 库，用于在 C# 应用程序中生成、编辑和处理 PDF 文档。IronPDF 支持渲染 HTML 创建的 PDF 文件这些内容包括：CSS、CSS、图像和 JavaScript。

它的核心功能在于从网络内容创建 PDF 文档，提供一种将 HTML 字符串、URL 和 ASPX 网络表单转换为 PDF 文件的简化方法。IronPDF 可在各种应用程序类型中高效运行，包括表单应用程序、服务器应用程序和网络应用程序。

如何安装 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)
    {
        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

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

IronPDF 许可

IronPDF 是一款商业产品，可根据不同需求提供各种许可证，包括个人许可证和商业许可证。每次购买均可获得终身许可和 30 天退款保证。 许可证 在购买许可证之前。

结论

C# 记录在简化 .NET 应用程序的数据建模方面迈出了重要一步。通过理解和利用记录，开发人员可以创建更可靠、可维护和可读的代码库。

无论您是开发大型应用程序还是简单的数据结构，记录所提供的功能（从不变性到基于值的相等性）都使其成为您 C# 工具包中不可或缺的工具。

IronPDF 提供了使用 免费试用 然后再决定是否购买。如果您发现该软件符合您的需求，您可以购买起价为 $749 的许可证。