C# Örtülü (Geliştiriciler için Nasıl Çalışır)

Parça Sınıfı Anlamak

Aynı erişilebilirlik düzeyini koruyan bir parça sınıf, C#'ta parça (partial) modifiye edicisi ile tanımlanır, bu sınıf tanımının aynı montaj içinde iki veya daha fazla dosyaya yayıldığını belirtir. Bu yaklaşım, ilgili kodu bir arada tutarken sorumlulukların ayrılmasını da sağlar. Örneğin, bir partial class Employee (parça sınıf Çalışan), iş mantığını bir dosyada ve veri erişim katmanını başka bir dosyada bulundurabilir, ancak her iki parça da tek bir sınıfta derlenir. Bu ayrım yalnızca kodu daha yönetilebilir hale getirmekle kalmaz, aynı zamanda birden fazla geliştiricinin çatışma olmadan aynı sınıf üzerinde çalışmasına imkan tanır.

// File 1: Employee_BusinessLogic.cs
public partial class Employee
{
    // Method for calculating pay
    public void CalculatePay() 
    { 
        // Implementation of pay calculation
    }
}

// File 2: Employee_DataAccess.cs
public partial class Employee
{
    // Method for loading employee data
    public void Load() 
    { 
        // Implementation of data loading
    }
}

// File 1: Employee_BusinessLogic.cs
public partial class Employee
{
    // Method for calculating pay
    public void CalculatePay() 
    { 
        // Implementation of pay calculation
    }
}

// File 2: Employee_DataAccess.cs
public partial class Employee
{
    // Method for loading employee data
    public void Load() 
    { 
        // Implementation of data loading
    }
}

' File 1: Employee_BusinessLogic.cs
Partial Public Class Employee
	' Method for calculating pay
	Public Sub CalculatePay()
		' Implementation of pay calculation
	End Sub
End Class

' File 2: Employee_DataAccess.cs
Partial Public Class Employee
	' Method for loading employee data
	Public Sub Load()
		' Implementation of data loading
	End Sub
End Class

Parça Metotları Kullanma

Parça sınıflar ayrıca parça metotlar tanımlayabilir, bu metotlar ilan edilir ancak mutlaka uygulanmaz. Bu metotlar, sınıfın bir kısmı bir metodu ilan edebilirken uygulamayıp, isteğe bağlı olarak sınıfın başka bir kısmına uygulanmasına izin verilebilecek durumları mümkün kılar. Eğer bir uygulama sağlanmazsa, parça metot çağrısı derleme zamanında kaldırılır ve performans cezası olmaz.

// File 1: Employee_BusinessLogic.cs
public partial class Employee
{
    // Declaration of a partial method to be called when pay is calculated
    partial void OnPayCalculated(double amount);

    public void CalculatePay()
    {
        double amount = 1000; // Simplified calculation
        OnPayCalculated(amount); // Call the partial method
    }
}

// File 2: Employee_Events.cs
public partial class Employee
{
    // Implementation of the partial method
    partial void OnPayCalculated(double amount)
    {
        Console.WriteLine($"Pay calculated: {amount}");
    }
}

// File 1: Employee_BusinessLogic.cs
public partial class Employee
{
    // Declaration of a partial method to be called when pay is calculated
    partial void OnPayCalculated(double amount);

    public void CalculatePay()
    {
        double amount = 1000; // Simplified calculation
        OnPayCalculated(amount); // Call the partial method
    }
}

// File 2: Employee_Events.cs
public partial class Employee
{
    // Implementation of the partial method
    partial void OnPayCalculated(double amount)
    {
        Console.WriteLine($"Pay calculated: {amount}");
    }
}

' File 1: Employee_BusinessLogic.cs
Partial Public Class Employee
	' Declaration of a partial method to be called when pay is calculated
	Partial Private Sub OnPayCalculated(ByVal amount As Double)
	End Sub

	Public Sub CalculatePay()
		Dim amount As Double = 1000 ' Simplified calculation
		OnPayCalculated(amount) ' Call the partial method
	End Sub
End Class

' File 2: Employee_Events.cs
Partial Public Class Employee
	' Implementation of the partial method
	Private Sub OnPayCalculated(ByVal amount As Double)
		Console.WriteLine($"Pay calculated: {amount}")
	End Sub
End Class

Gelişmiş Parça Metotları Kullanımı

Parça metotlar, parça tanımı yaklaşımını somutlaştırarak, bir parça sınıfın bir bölümünde bir deklarasyon ve başka bir bölümünde isteğe bağlı bir uygulama sağlar. Bu özellik, geliştiriciler tarafından isteğe bağlı olarak uygulanabilecek üretilmiş koda kancalar sağlamak için özellikle kullanışlıdır. partial anahtar kelimesi, metodun bir uygulaması olup olmayacağını belirtir.

Bir UI bileşeni yüklendiğinde yüklenmeden önce bir işlem yapması gerektiği bir örnek düşünün. Parça metot, otomatik olarak oluşturulan kodu karıştırmadan özel iş mantığını eklemek için temiz bir yol sağlar.

// File: UIControls_AutoGenerated.cs
public partial class UIControls
{
    // Declaration of a partial method for control loading
    partial void OnControlLoading();

    public void LoadControl()
    {
        OnControlLoading(); // Call the partial method
        // Auto-generated loading logic here
    }
}

// File: UIControls_CustomLogic.cs
public partial class UIControls
{
    // Implementation of the partial method for adding custom logic
    partial void OnControlLoading()
    {
        // Custom business logic code here
        Console.WriteLine("Custom control loading logic executed.");
    }
}

// File: UIControls_AutoGenerated.cs
public partial class UIControls
{
    // Declaration of a partial method for control loading
    partial void OnControlLoading();

    public void LoadControl()
    {
        OnControlLoading(); // Call the partial method
        // Auto-generated loading logic here
    }
}

// File: UIControls_CustomLogic.cs
public partial class UIControls
{
    // Implementation of the partial method for adding custom logic
    partial void OnControlLoading()
    {
        // Custom business logic code here
        Console.WriteLine("Custom control loading logic executed.");
    }
}

' File: UIControls_AutoGenerated.cs
Partial Public Class UIControls
	' Declaration of a partial method for control loading
	Partial Private Sub OnControlLoading()
	End Sub

	Public Sub LoadControl()
		OnControlLoading() ' Call the partial method
		' Auto-generated loading logic here
	End Sub
End Class

' File: UIControls_CustomLogic.cs
Partial Public Class UIControls
	' Implementation of the partial method for adding custom logic
	Private Sub OnControlLoading()
		' Custom business logic code here
		Console.WriteLine("Custom control loading logic executed.")
	End Sub
End Class

// File: Employee_AutoGenerated.cs
public partial class Employee
{
    // Auto-generated properties and methods
}

// File: Employee_BusinessLogic.cs
public partial class Employee
{
    // Business logic method for promoting an employee
    public void Promote()
    {
        // Business logic code to promote an employee
        Console.WriteLine("Employee promoted.");
    }
}

// File: Employee_AutoGenerated.cs
public partial class Employee
{
    // Auto-generated properties and methods
}

// File: Employee_BusinessLogic.cs
public partial class Employee
{
    // Business logic method for promoting an employee
    public void Promote()
    {
        // Business logic code to promote an employee
        Console.WriteLine("Employee promoted.");
    }
}

' File: Employee_AutoGenerated.cs
Partial Public Class Employee
	' Auto-generated properties and methods
End Class

' File: Employee_BusinessLogic.cs
Partial Public Class Employee
	' Business logic method for promoting an employee
	Public Sub Promote()
		' Business logic code to promote an employee
		Console.WriteLine("Employee promoted.")
	End Sub
End Class

// File: ComplexControl_Part1.cs
public partial class ComplexControl
{
    public partial class NestedControl
    {
        // Method for initializing the nested control
        public void Initialize() 
        { 
            // Initialization code here 
        }
    }
}

// File: ComplexControl_Part2.cs
public partial class ComplexControl
{
    public partial class NestedControl
    {
        // Method for cleaning up the nested control
        public void Cleanup() 
        { 
            // Cleanup code here 
        }
    }
}

// File: ComplexControl_Part1.cs
public partial class ComplexControl
{
    public partial class NestedControl
    {
        // Method for initializing the nested control
        public void Initialize() 
        { 
            // Initialization code here 
        }
    }
}

// File: ComplexControl_Part2.cs
public partial class ComplexControl
{
    public partial class NestedControl
    {
        // Method for cleaning up the nested control
        public void Cleanup() 
        { 
            // Cleanup code here 
        }
    }
}

' File: ComplexControl_Part1.cs
Partial Public Class ComplexControl
	Partial Public Class NestedControl
		' Method for initializing the nested control
		Public Sub Initialize()
			' Initialization code here 
		End Sub
	End Class
End Class

' File: ComplexControl_Part2.cs
Partial Public Class ComplexControl
	Partial Public Class NestedControl
		' Method for cleaning up the nested control
		Public Sub Cleanup()
			' Cleanup code here 
		End Sub
	End Class
End Class

Pratik Uygulamalar

Parça sınıflar, Visual Studio'nun Windows Forms oluşturduğu Forms gibi otomatik oluşturulmuş kaynak kod içeren senaryolarda özellikle faydalıdır. Bu yapı, geliştiricilerin UI tasarım kodunu ayrı bir kaynak dosyasına ayırmasına olanak tanır, böylece sınıfı orijinal UI tasarımını etkilemeden genişletip değiştirebilirler.

Web uygulamalarında parça sınıflar, oluşturulmuş web hizmet sarmalayıcı kodunu özel iş mantığından ayırmayı sağlar, böylece web hizmetlerine yapılan güncellemeler özel değişiklikleri geçersiz kılmaz. Benzer şekilde, LINQ to SQL kullanan uygulamalarda, dbml dosyaları otomatik olarak oluşturulan kodu etkilemeden ek işlevsellik veya iş mantığı ekleyebilecek parça sınıf tanımları üretir.

// Auto-generated UI class
public partial class MainForm : Form
{
    // Designer code
}

// Custom logic for MainForm
public partial class MainForm
{
    // Custom event handlers and methods
}

// Auto-generated UI class
public partial class MainForm : Form
{
    // Designer code
}

// Custom logic for MainForm
public partial class MainForm
{
    // Custom event handlers and methods
}

' Auto-generated UI class
Partial Public Class MainForm
	Inherits Form

	' Designer code
End Class

' Custom logic for MainForm
Partial Public Class MainForm
	Inherits Form

	' Custom event handlers and methods
End Class

IronPDF: C# PDF Kütüphanesi

IronPDF, .NET için geliştiricilerin uygulamalarında PDF belgeleri oluşturmasına, okumalarına ve düzenlemesine izin veren kapsamlı bir kütüphanedir. HTML'den IronPDF kullanarak PDF'ler oluşturmayı, URL'leri, resimleri, ASPX ve metni kolaylaştırır, bu da raporlama, belge oluşturma ve web içeriği arşivleme için çok yönlü bir araç haline getirir. IronPDF, minimum kurulum gerektirir ve C# ile geliştirilmiş uygulamaları da içeren herhangi bir .NET projesine entegre edilirken kullanım kolaylığı ile öne çıkar.

IronPDF'i Parça Sınıflarla Entegre Etme

IronPDF'i parça sınıflarla entegre etmenin bir örneğini ele alalım; PDF formatında raporlar üreten bir web uygulamamız olduğunu varsayalım. İş mantığımızı PDF oluşturma mantığımızdan ayırmak için işlevselliği parça sınıf dosyalarına böleceğiz.

Install-Package IronPdf

public partial class ReportGenerator
{
    // Method to get data for the report
    public IEnumerable<string> GetDataForReport()
    {
        // Imagine this method fetches and prepares data for the report
        return new List<string> { "Data1", "Data2", "Data3" };
    }
}

public partial class ReportGenerator
{
    // Method to get data for the report
    public IEnumerable<string> GetDataForReport()
    {
        // Imagine this method fetches and prepares data for the report
        return new List<string> { "Data1", "Data2", "Data3" };
    }
}

Partial Public Class ReportGenerator
	' Method to get data for the report
	Public Function GetDataForReport() As IEnumerable(Of String)
		' Imagine this method fetches and prepares data for the report
		Return New List(Of String) From {"Data1", "Data2", "Data3"}
	End Function
End Class

public partial class ReportGenerator
{
    // Method to generate PDF report using IronPDF
    public void GeneratePdfReport()
    {
        var renderer = new IronPdf.ChromePdfRenderer();
        var data = GetDataForReport();
        var htmlContent = $"<html><body><h1>Report</h1><p>{string.Join("</p><p>", data)}</p></body></html>";

        // Generate PDF from HTML string
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF to a file
        pdf.SaveAs("Report.pdf");
        Console.WriteLine("Report generated successfully.");
    }
}

public partial class ReportGenerator
{
    // Method to generate PDF report using IronPDF
    public void GeneratePdfReport()
    {
        var renderer = new IronPdf.ChromePdfRenderer();
        var data = GetDataForReport();
        var htmlContent = $"<html><body><h1>Report</h1><p>{string.Join("</p><p>", data)}</p></body></html>";

        // Generate PDF from HTML string
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF to a file
        pdf.SaveAs("Report.pdf");
        Console.WriteLine("Report generated successfully.");
    }
}

Partial Public Class ReportGenerator
	' Method to generate PDF report using IronPDF
	Public Sub GeneratePdfReport()
		Dim renderer = New IronPdf.ChromePdfRenderer()
		Dim data = GetDataForReport()
		Dim htmlContent = $"<html><body><h1>Report</h1><p>{String.Join("</p><p>", data)}</p></body></html>"

		' Generate PDF from HTML string
		Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)

		' Save the PDF to a file
		pdf.SaveAs("Report.pdf")
		Console.WriteLine("Report generated successfully.")
	End Sub
End Class

var reportGenerator = new ReportGenerator();
reportGenerator.GeneratePdfReport();

var reportGenerator = new ReportGenerator();
reportGenerator.GeneratePdfReport();

Dim reportGenerator As New ReportGenerator()
reportGenerator.GeneratePdfReport()

Sonuç

C#'taki parça sınıflar, parça metotlar ve iç içe geçmiş parça türlerinin kullanımı, geliştiricilere kod organizasyonu ve yönetimi için esnek ve güçlü bir araç sağlar. Otomatik oluşturulan kodu iş mantığı, kullanıcı arayüzü kontrol tanımları ve uygulamanın diğer bölümlerinden ayırarak, geliştiriciler daha sürdürülebilir, okunabilir ve ölçeklenebilir uygulamalar oluşturabilir.

İş mantığı ve PDF işleme endişelerini ayırarak, geliştiriciler daha iyi kod organizasyonu, sürdürülebilirlik ve ölçeklenebilirlik elde edebilir. IronPDF'in sağlam özellikleriyle parça sınıfların organizasyonel faydaları .NET geliştiricileri için projelerindeki PDF'ler ile çalışırken güçlü bir araç seti oluşturur. IronPDF'i ücretsiz deneme sürümüyle deneyebilirsiniz. Satın almakla ilgileniyorsanız, IronPDF'in lisansı $999'den başlamaktadır.