.NET 幫助

C# 解構函式 (開發者如何使用)

發佈 2024年7月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

VB C#

在上述範例中，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

VB C#

在此例中，public static void Main 方法創建了一個新的 Person，然後使用解構器提取 Name 和 Age。當程式運行時，這個方法會被隱式呼叫，從而簡化了從物件中提取數據的過程。

C# 解構函數（對開發者而言的工作原理）：圖 1 - 解構函數 C# 的主控台輸出：「姓名：Iron Developer，年齡：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

VB C#

在此範例中，Book 類別包含三個屬性：Title、Author 和 Pages。 DeconstructBook()method 方法接收一個 Book 類別的實例並返回一個包含這些屬性值的元組。在 Main 中的解構陳述句()方法然後分別將這些值指派給變數title、author和pages`。這樣，您可以輕鬆地存取個別值，而無需直接引用 Book 對象。

深入解構器機制探討

核心功能與特性

解構器提供了一種從物件中顯式提取資訊的方法。必須明確呼叫它們以檢索資料。這確保了信息可以被直接且立即地訪問。解構函式簡化了將物件分解為各部分的過程。它們對於模式匹配和數值提取特別有用。

繼承和解構子

如果基礎類別有解構子，則可以在派生類別中擴展或覆寫。這遵循繼承鏈，允許應用擴展方法，從而可以進一步自定義解構過程。這在衍生類別包含需要與從基類繼承的屬性一起提取的其他屬性時特別有用。

IronPDF 與解構器

IronPDF 是一個 .NET 程式庫，讓使用 C# 創建、編輯和管理 PDF 文件變得輕鬆簡單。 IronPDF 使用 Chrome 渲染引擎進行此轉換。它確保 PDF 外觀準確且清晰。它允許開發者專注於以 HTML 設計其內容，而無需擔心複雜的 PDF 生成細節。 IronPDF 支援將 HTML 直接轉換為 PDF。它也可以將網頁表單、網址和圖像轉換為 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

VB C#

C# 解構器 (開發人員使用說明)：圖 2 - 主控台輸出顯示 PDF 頁數和作者信息。