C# Deconstructor (Geliştiriciler İçin Nasıl Çalışır)

Temel Bir Ayırıcı Örneği

Basit bir Person sınıfını düşünün. Bu sınıf, nesneyi isim ve yaşa bölen bir yok ediciye sahip olabilir. İşte bunu nasıl tanımlayabilirsiniz:

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

    // Deconstructor method to split Person object into its properties
    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; }

    // Deconstructor method to split Person object into its properties
    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

	' Deconstructor method to split Person object into its properties
	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

Yukarıdaki örnekte, Person sınıfının Deconstruct metoduna sahip olduğunu ve bu metodun Name ve Age özelliklerini çıktıladığını görebilirsiniz. Bu, özellikle bu değerleri değişkenlere hızlı bir şekilde atamak istediğinizde faydalıdır.

Pratik Uygulama

Bir yapıcıyı kullanmak için genellikle demet ayıklama sözdizimini kullanırsınız. İşte Person sınıfı için deconstructor'u nasıl kullanabileceğiniz:

public static void Main()
{
    // Create a new Person instance
    Person person = new Person { Name = "Iron Developer", Age = 30 };

    // Use the deconstructor to assign values to the tuple elements
    (string name, int age) = person;

    // Output the extracted values
    Console.WriteLine($"Name: {name}, Age: {age}");
}

public static void Main()
{
    // Create a new Person instance
    Person person = new Person { Name = "Iron Developer", Age = 30 };

    // Use the deconstructor to assign values to the tuple elements
    (string name, int age) = person;

    // Output the extracted values
    Console.WriteLine($"Name: {name}, Age: {age}");
}

Public Shared Sub Main()
	' Create a new Person instance
	Dim person As New Person With {
		.Name = "Iron Developer",
		.Age = 30
	}

	' Use the deconstructor to assign values to the tuple elements
'INSTANT VB TODO TASK: VB has no equivalent to C# deconstruction declarations:
	(String name, Integer age) = person

	' Output the extracted values
	Console.WriteLine($"Name: {name}, Age: {age}")
End Sub

Bu durumda, public static void Main metodu yeni bir Person oluşturur ve ardından deconstructor'u kullanarak Name ve Age çıkarır. Bu yöntem, program çalıştığında dolaylı olarak çağrılır ve nesnelerden veri çıkarımını basitleştirir.

Tuple Ayrıştırma

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

    // Deconstructor method 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}");
    }

    // Deconstructor method 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

	' Deconstructor method 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

Ana Özellikler ve Davranış

Deconstructorlar, bir nesneden bilgi çıkarmanın açık bir yolunu sunar. Verileri almak için açıkça çağrılmaları gerekir. Bu, bilgilere doğrudan ve hemen erişilebilmesini sağlar. Deconstructorlar, bir nesneyi bileşenlerine ayırma sürecini basitleştirir. Özellikle pattern matching ve değer çıkarımı için kullanışlıdırlar.

Kalıtım ve Deconstructorlar

Eğer bir taban sınıf bir deconstructor'a sahipse, türetilmiş bir sınıfta genişletilebilir veya geçersiz kılınabilir. Bu, kalıtım zincirini takip ederek genişletme yöntemlerinin uygulanmasına olanak tanır ve deconstruct işlemi özelleştirilebilir. Bu, özellikle türetilmiş sınıf, taban sınıftan kalıtılan özelliklerle birlikte ek özellikler içerdiğinde kullanışlıdır.

Kod Örneği

Aşağıdaki kod, HTML içeriğinden bir PDF oluşturmak ve ardından oluşan PDF belgesini daha fazla işlemler için deconstruct etmek için IronPDF'i C#'ta nasıl kullanabileceğinizi gösterir. Bu, birden çok yöntem çağrısı veya geçici değişkenlere ihtiyaç duymadan, özellikleri okuma gibi işlemler için kullanılabilir. Bu, oluşturma ve deconstruct yönlerini vurgulayan temel bir kullanım modelidir:

using IronPdf;

public class PdfGenerator
{
    public static void Main()
    {
        // Set your License Key
        License.LicenseKey = "License-Key";

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

        // Generate a PDF from HTML content
        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}");
    }

    // Deconstructor method 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()
    {
        // Set your License Key
        License.LicenseKey = "License-Key";

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

        // Generate a PDF from HTML content
        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}");
    }

    // Deconstructor method 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()
		' Set your License Key
		License.LicenseKey = "License-Key"

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

		' Generate a PDF from HTML content
		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

	' Deconstructor method 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

Bu C# örneği, bir PDF belgesinden özellikleri elde etme sürecini soyutlar ve pratik senaryolarda kod yapınızı basitleştirmek ve okunabilirliğini artırmak için bir deconstructor nasıl kullanabileceğinizi açığa çıkarır. Unutmayın, IronPDF doğal olarak deconstructorları desteklemez; bu yalnızca gösterim amacıyla yapılmış bir özelleştirilmiş uygulamadır.