.NET 帮助

C# 析构器（开发者如何使用）

雷根·彭

2024年七月1日

解构者在 C# 中，这些方法可帮助您将一个对象分解为多个值。这与析构函数截然不同，后者用于在对象被垃圾回收之前清理资源。解构器可以让您轻松地从对象中提取值。对于处理复杂数据结构并需要快速、干净地访问对象部分内容的开发人员来说，了解解构器非常有帮助。我们将探讨什么是解构器以及它与 IronPDF 库的用法。

什么是解构器？

C# 中的解构器是在类中定义的，它专门处理将对象分解成若干部分的问题。您使用 "public void Deconstruct "方法定义了一个解构器。该方法使用参数返回对象的组件。每个参数对应对象中的一段数据。关键是要将其与析构函数区分开来，后者通常使用 protected override void Finalize 进行定义。

基本解构实例

考虑一个简单的 Person 类。该类可以有一个解构器，将对象拆分为名称和年龄。您可以这样定义

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
    public void Deconstruct(out string name, out int age)
    {
        name = this.Name;
        age = this.Age;
    }
}

public class Person
{
    public string Name { get; set; }
    public int Age { get; set; }
    public void Deconstruct(out string name, out int age)
    {
        name = this.Name;
        age = this.Age;
    }
}

Public Class Person
	Public Property Name() As String
	Public Property Age() As Integer
	Public Sub Deconstruct(<System.Runtime.InteropServices.Out()> ByRef name As String, <System.Runtime.InteropServices.Out()> ByRef age As Integer)
		name = Me.Name
		age = Me.Age
	End Sub
End Class

在上例中，"Person "类有一个 "Deconstruct "方法，用于输出 "Name "和 "Age "属性。当您想快速将这些值赋值给变量时，这一点尤其有用。

在代码中使用解构器

实际应用

要使用解构器，通常需要使用元组解构语法。以下是如何使用 Person 类的解构器：

public static void Main()
{
    Person person = new Person { Name = "Iron Developer", Age = 30 };
    (string name, int age) = person;
    Console.WriteLine($"Name: {name}, Age: {age}");
}

public static void Main()
{
    Person person = new Person { Name = "Iron Developer", Age = 30 };
    (string name, int age) = person;
    Console.WriteLine($"Name: {name}, Age: {age}");
}

Public Shared Sub Main()
	Dim person As New Person With {
		.Name = "Iron Developer",
		.Age = 30
	}
'INSTANT VB TODO TASK: VB has no equivalent to C# deconstruction declarations:
	(String name, Integer age) = person
	Console.WriteLine($"Name: {name}, Age: {age}")
End Sub

该实例中的 "public static void Main "方法创建了一个新的 "Person"，然后使用解构器提取了 "Name "和 "Age"。该方法在程序运行时被隐式调用，从而简化了从对象中提取数据的过程。

C# 解构器（如何为开发人员工作）：图 1 - C# 解构器的控制台输出：姓名：Iron Developer，年龄：30钢铁开发人员，年龄：30

元组解构

元组解构是从元组中提取值并将其分配给单个变量的便捷方法。该功能可让您在单个语句中将元组分解为各个组成部分，从而使您的代码更简洁、更易读。

示例

下面是如何用 C# 来解构元组：

using System;
public class Program
{
    public static void Main()
    {
        // Create an instance of the Book class
        var book = new Book
        {
            Title = "C# Programming",
            Author = "Jon Skeet",
            Pages = 300
        };

        // Deconstruct the book object to get properties directly
        var (title, author, pages) = DeconstructBook(book);

        // Output the deconstructed properties
        Console.WriteLine($"Title: {title}, Author: {author}, Pages: {pages}");
    }

    // Example of a deconstructor for a Book class
    private static (string title, string author, int pages) DeconstructBook(Book book)
    {
        return (book.Title, book.Author, book.Pages);
    }
}

public class Book
{
    public string Title { get; set; }
    public string Author { get; set; }
    public int Pages { get; set; }
}

using System;
public class Program
{
    public static void Main()
    {
        // Create an instance of the Book class
        var book = new Book
        {
            Title = "C# Programming",
            Author = "Jon Skeet",
            Pages = 300
        };

        // Deconstruct the book object to get properties directly
        var (title, author, pages) = DeconstructBook(book);

        // Output the deconstructed properties
        Console.WriteLine($"Title: {title}, Author: {author}, Pages: {pages}");
    }

    // Example of a deconstructor for a Book class
    private static (string title, string author, int pages) DeconstructBook(Book book)
    {
        return (book.Title, book.Author, book.Pages);
    }
}

public class Book
{
    public string Title { get; set; }
    public string Author { get; set; }
    public int Pages { get; set; }
}

Imports System
Public Class Program
	Public Shared Sub Main()
		' Create an instance of the Book class
		Dim book As New Book With {
			.Title = "C# Programming",
			.Author = "Jon Skeet",
			.Pages = 300
		}

		' Deconstruct the book object to get properties directly
'INSTANT VB TODO TASK: VB has no equivalent to C# deconstruction declarations:
		var(title, author, pages) = DeconstructBook(book)

		' Output the deconstructed properties
		Console.WriteLine($"Title: {title}, Author: {author}, Pages: {pages}")
	End Sub

	' Example of a deconstructor for a Book class
	Private Shared Function DeconstructBook(ByVal book As Book) As (title As String, author As String, pages As Integer)
		Return (book.Title, book.Author, book.Pages)
	End Function
End Class

Public Class Book
	Public Property Title() As String
	Public Property Author() As String
	Public Property Pages() As Integer
End Class

在本例中，"Book "类包含三个属性：标题"、"作者 "和 "页数"。解构书()该方法获取一个 Book 类的实例，并返回一个包含这些属性值的元组。主文件 "中的解构语句()然后，"方法 "会将这些值分别赋值给变量 "title"、"author "和 "pages"。这样，您就可以轻松访问各个值，而无需直接引用图书对象。

深入了解解构机原理

主要功能和行为

解构器提供了一种从对象中明确提取信息的方法。必须明确调用这些工具来检索数据。这样才能确保信息可以直接、即时地获取。解构器简化了将对象分解为各个部分的过程。这些工具对于模式匹配和数值提取特别有用。

继承和解构器

如果基类具有解构器，则可以在派生类中对其进行扩展或重写。这将遵循继承链，允许应用扩展方法，从而进一步定制解构过程。当派生类包含需要提取的额外属性以及从基类继承的属性时，这一点尤其有用。

IronPDF 与解构工具

IronPDF for .NET 是一个 .NET 库，可以使用 C# 轻松创建、编辑和管理 PDF 文件。 IronPdf 使用 Chrome 渲染引擎进行此次转换。它能确保 PDF 文件看起来准确、清晰。这样，开发人员就可以专注于 HTML 内容的设计，而不必担心复杂的 PDF 生成细节。 IronPDF 支持将 HTML 直接转换为 PDF。它还可以将网络表单、URL 和图片转化为 PDF 文档。在编辑方面，您可以为 PDF 添加文本、图像、页眉和页脚。它还能让您使用密码和数字签名保护 PDF 安全。

代码示例

下面的代码展示了如何在 C# 中使用 IronPDF 从 HTML 内容生成 PDF，然后使用解构器处理生成的 PDF 文档，以便进行读取属性等进一步操作，而无需调用多个方法或临时变量。这是一种强调生成和解构方面的基本使用模式：

using IronPdf;
public class PdfGenerator
{
    public static void Main()
    {
        License.LicenseKey = "License-Key";

        // Create an instance of the PDF generator
        var renderer = new ChromePdfRenderer();

        // Generate a PDF from HTML
        var pdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF!</h1>");

        // Deconstruct the PDF document to get properties directly
        var (pageCount, author) = DeconstructPdf(pdfDocument);

        // Output the deconstructed properties
        Console.WriteLine($"Page Count: {pageCount}, Author: {author}");
    }

    // Example of a deconstructor for a PdfDocument
    private static (int pageCount, string author) DeconstructPdf(PdfDocument document)
    {
        return (document.PageCount, document.MetaData.Author);
    }
}

using IronPdf;
public class PdfGenerator
{
    public static void Main()
    {
        License.LicenseKey = "License-Key";

        // Create an instance of the PDF generator
        var renderer = new ChromePdfRenderer();

        // Generate a PDF from HTML
        var pdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF!</h1>");

        // Deconstruct the PDF document to get properties directly
        var (pageCount, author) = DeconstructPdf(pdfDocument);

        // Output the deconstructed properties
        Console.WriteLine($"Page Count: {pageCount}, Author: {author}");
    }

    // Example of a deconstructor for a PdfDocument
    private static (int pageCount, string author) DeconstructPdf(PdfDocument document)
    {
        return (document.PageCount, document.MetaData.Author);
    }
}

Imports IronPdf
Public Class PdfGenerator
	Public Shared Sub Main()
		License.LicenseKey = "License-Key"

		' Create an instance of the PDF generator
		Dim renderer = New ChromePdfRenderer()

		' Generate a PDF from HTML
		Dim pdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello, IronPDF!</h1>")

		' Deconstruct the PDF document to get properties directly
'INSTANT VB TODO TASK: VB has no equivalent to C# deconstruction declarations:
		var(pageCount, author) = DeconstructPdf(pdfDocument)

		' Output the deconstructed properties
		Console.WriteLine($"Page Count: {pageCount}, Author: {author}")
	End Sub

	' Example of a deconstructor for a PdfDocument
	Private Shared Function DeconstructPdf(ByVal document As PdfDocument) As (pageCount As Integer, author As String)
		Return (document.PageCount, document.MetaData.Author)
	End Function
End Class

C# 解构器（如何为开发人员工作）：图 2 - 显示 PDF 页数和作者信息的控制台输出。

本 C# 示例抽象了从 PDF 文档中获取属性的过程，说明了如何在实际场景中使用解构器来简化代码结构并提高可读性。请记住，IronPDF 本身并不支持解构器；这只是一个用于演示的自定义实现。

结论

总而言之解构者.NET、Java、Python 或 Node js 中的 C# 是功能强大的工具，可让开发人员高效地处理和操作对象中的数据。通过了解如何实现和使用解构器，您可以更有效地管理复杂数据，确保在需要时可以访问对象的所有组件。无论您处理的是简单还是复杂的对象，掌握解构器都将大大提高您的编码效率和管理数据结构的精确度。

了解 IronPdf 定价和许可选项从 $749 开始。

雷根·彭

立即与工程团队聊天

软件工程师

Regan毕业于雷丁大学，拥有电子工程学士学位。在加入Iron Software之前，他的前工作职位要求他专注于单一任务；他在Iron Software最喜欢的是能进行多种工作，无论是增加销售价值、技术支持、产品开发还是营销。他喜欢了解开发人员如何使用Iron Software的库，并利用这些知识不断改进文档和开发产品。

< 前一页
Deedle C#（开发人员如何使用它）

下一步 >
Appmetrics C#（开发人员如何使用）