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

Basit bir Deconstructor Örneği

Basit bir Person sınıfını düşünün. Bu sınıf, nesneyi isim ve yaşa ayıran bir deconstructor'a sahip olabilir. İşte bunu nasıl tanımlayabileceğiniz:

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ı, Name ve Age özelliklerini çıktı olarak veren bir Deconstruct yöntemi içerir. Bu, bu değerleri hızla değişkenlere atamak istediğinizde özellikle yararlıdır.

Pratik Uygulama

Bir deconstructor kullanmak için tipik olarak tuple deconstruction sözdizimini kullanırsınız. Person sınıfı için deconstructor'u nasıl kullanabileceğiniz aşağıda gösterilmektedir:

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 örnekteki public static void Main yöntemi yeni bir Person oluşturur ve ardından Name ve Age'yı çıkarmak için deconstructor'u kullanır. Bu yöntem, program çalıştığında örtük olarak çağrılır, nesnelerden veri çıkarmayı basitleştirir.

Tuple Dekonstrüksiyonu

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ış

Deconstructor'lar, bir nesneden bilgiyi açıkça çıkarmanın bir yolunu sunar. Verileri almak için açıkça çağrılmaları gerekir. Bu, bilginin doğrudan ve hemen erişilebilir olmasını sağlar. Deconstructor'lar, bir nesneyi parçalara ayırma sürecini basitleştirir. Özellikle desen eşleştirme ve değer çıkarmada çok faydalıdırlar.

Kalıtım ve Deconstructor'lar

Eğer bir temel sınıf bir deconstructor'a sahipse, bir türetilmiş sınıfta genişletilip veya geçersiz kılınabilir. Bu, kalıtım zincirini takip eder ve deconstruction sürecini daha da özelleştirebilecek uzatma yöntemlerinin uygulanmasına olanak tanır. Bu, özellikle türetilmiş sınıfın, temel sınıfta kalıtılanlarla birlikte çıkarılması gereken ek özellikler içerdiğinde çok faydalıdır.

Kod Örneği

Aşağıdaki kod, HTML içeriğinden bir PDF oluşturmak için C#'ta IronPDF'i nasıl kullanabileceğinizi ve ardından bir deconstructor kullanarak çıkarılan PDF belgesi üzerinde daha fazla işlem yapmak için özellikleri okuma gibi işlemleri nasıl yapabileceğinizi gösteriyor. Bu, oluşturma ve deconstruction yönlerine vurgu yapan temel bir kullanım örneğidir:

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 özelliklerin nasıl alınacağı sürecini soyutlaştırarak, pratik senaryolarda kod yapınızı basitleştirmek ve okunabilirliği artırmak için bir deconstructor'ı nasıl kullanabileceğinizi göstermektedir. Unutmayın, IronPDF doğal olarak deconstructors'u desteklemez; bu sadece gösterim amacıyla yapılmış bir özel uygulamadır.