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

Partial Sınıfı Anlamak

Bir partial sınıf, aynı erişim seviyesini koruyarak, C# dilinde partial değiştiricisiyle tanımlanır ve sınıf tanımının aynı montaj içinde iki veya daha fazla dosyaya yayıldığını gösterir. Bu yaklaşım, ilgili kodların birlikte kalmasını sağlarken, sorumlulukların ayrılmasını korur. Örneğin, partial sınıfı Employee bir dosyada iş mantığına ve başka bir dosyada veri erişim katmanına sahip olabilir, ancak her iki parça da tek bir sınıf haline getirilecektir. Bu ayrım, kodun daha yönetilebilir olmasını sağladığı gibi, birden fazla geliştiricinin aynı sınıf üzerinde çakışmadan çalışmasına da olanak 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

Partial Yöntemlerden Yararlanmak

Partial sınıflar, ayrıca tanımlanmış, ancak uygulanmayan partial yöntemler de belirleyebilir. Bu yöntemler, sınıfın bir kısmının bir yöntemi uygulamadan ilan edebileceği ve isteğe bağlı olarak sınıfın başka bir kısmının bu yöntemi uygulayabileceği senaryoları sağlar. Eğer bir uygulama sağlanmazsa, partial yöntem çağrısı derleme zamanında devre dışı bırakılır, bu da performans cezası oluşturmaz.

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

Partial Yöntemlerin İleri Düzey Kullanımı

Partial yöntemler, bir partial tanım yaklaşımının soma bir kısmında bir deklarasyon ve başka bir kısımda isteğe bağlı bir uygulama içeren bir yöntem ortaya koymasına izin verir. Bu özellik, geliştiriciler tarafından isteğe bağlı olarak uygulanabilen oluşturulmuş kodlarda kancalar sağlamak için özellikle faydalıdır. Partial anahtar kelimesi, yöntemin bir uygulamaya sahip olabileceğini veya olmayacağını belirtir.

Bir UI bileşeninin, bir kullanıcı arabirimi kontrolü yüklenmeden önce bir işlem gerçekleştirmesi gereken bir örneği düşünün. Partial yöntem, özel iş mantığını otomatik oluşturulmuş kodu karıştırmadan eklemenin temiz bir yolunu 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

Partial sınıflar, özellikle Formlar gibi otomatik olarak oluşturulan kaynak kodlarını içeren senaryolarda faydalıdır ve Visual Studio, Windows Formlarını oluşturur. Bu yapılandırma, geliştiricilerin, orijinal kullanıcı arayüzü tasarımını etkilemeden sınıfı genişletmek veya değiştirmek için ayrı bir kaynak dosyasındaki kullanıcı arayüzü tasarım kodunu ayırmalarına olanak tanır.

Web uygulamalarında, partial sınıflar, oluşturulmuş web hizmeti sarmalayıcı kodunu iş mantığından ayırarak, web hizmetlerine yapılan güncelleştirmelerin özel değişiklikleri geçersiz kılmamasını sağlar. Benzer şekilde, LINQ to SQL kullanan uygulamalarda, dbml dosyaları, otomatik oluşturulan kodlara dokunmadan ek işlevsellik veya iş mantığı dahil edilmek üzere genişletilebilen partial sınıf tanımları oluşturur.

// 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 kapsamlı bir kütüphanedir ve geliştiricilerin uygulamalarında PDF belgelerini oluşturmasına, okumasına ve düzenlemesine olanak tanır. IronPDF, HTML, URL'ler, resimler, ASPX ve metin kullanarak PDF oluşturmak için basit bir yaklaşım sunar ve raporlama, belge oluşturma ve web içeriği arşivleme için çok yönlü bir araç haline getirir. IronPDF, C# ile geliştirilen uygulamalar da dahil olmak üzere, herhangi bir .NET projesine entegre etmek için en az kurulum gerektirerek kullanım kolaylığı açısından mükemmeldir.

IronPDF'ü Partial Sınıflarla Entegre Etmek

IronPDF'ün partial sınıflarla entegrasyonunu nasıl gerçekleştireceğimizi örnekleyelim; PDF formatında rapor oluşturan bir web uygulamasına sahip olalım. İş mantığımızı PDF oluşturma mantığımızdan ayırmak için işlevselliği partial 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#'ta kısmi sınıflar, kısmi yöntemler ve iç içe kısmi türler 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 daha sürdürülebilir, okunabilir ve ölçeklenebilir uygulamalar oluşturabilirsiniz.

İş mantığı ve PDF işleme endişelerini ayırarak, geliştiriciler daha iyi kod organizasyonu, sürdürülebilirlik ve ölçeklenebilirlik elde edebilirler. IronPDF'nin sağlam özellikleri, kısmi sınıfların organizasyonel avantajlarıyla birleştiğinde, projelerinde PDF'lerle çalışan .NET geliştiricileri için güçlü bir araç seti oluşturur. IronPDF'nin ücretsiz denemesini kullanarak IronPDF'yi ücretsiz deneyebilirsiniz. Satın almayla ilgileniyorsanız, IronPDF lisansı $799 itibaren başlamaktadır.