C# Partial (Funktionsweise für Entwickler)

Verständnis der partiellen Klasse

Eine partielle Klasse, die das gleiche Zugriffslevel beibehält, wird mit dem partiellen Modifikator in C# definiert, was darauf hinweist, dass die Klassendefinition über zwei oder mehr Dateien innerhalb derselben Assembly verteilt ist. Dieser Ansatz hält zusammengehörigen Code zusammen, während die Trennung von Belangen aufrechterhalten wird. Ein Beispiel: Eine partielle Klasse Mitarbeiter könnte in einer Datei ihre Geschäftslogik und in einer anderen ihre Datenzugriffsschicht haben, doch beide Teile werden in eine einzelne Klasse kompiliert. Diese Trennung macht den Code nicht nur besser handhabbar, sondern erlaubt auch mehreren Entwicklern, an derselben Klasse zu arbeiten, ohne Konflikte.

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

Partielle Methoden nutzen

Partielle Klassen können auch partielle Methoden definieren, die deklariert, aber nicht zwingend implementiert werden müssen. Diese Methoden ermöglichen Szenarien, in denen ein Teil der Klasse eine Methode deklarieren kann, ohne sie zu implementieren, wobei ein anderer Teil der Klasse sie optional implementieren kann. Wenn keine Implementierung bereitgestellt wird, wird der Teilmethodenaufruf zur Compile-Zeit entfernt, wodurch keine Leistungsstrafe entsteht.

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

Fortgeschrittene Verwendung von Partialmethoden

Partielle Methoden, die einen Ansatz für partielle Definitionen darstellen, ermöglichen eine Deklaration in einem Teil einer teilweisen Klasse und eine optionale Implementierung in einem anderen. Dieses Merkmal ist besonders nützlich, um Haken in generiertem Code bereitzustellen, die optional von Entwicklern implementiert werden können. Das partielle Schlüsselwort zeigt an, dass die Methode möglicherweise eine Implementierung hat oder nicht.

Betrachten wir ein Beispiel, bei dem eine UI-Komponente eine Aktion vor dem Laden eines Benutzeroberflächenkontrollens durchführen muss. Die partielle Methode bietet eine saubere Möglichkeit, benutzerdefinierte Geschäftslogik einzufügen, ohne den automatisch generierten Code zu überladen.

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

Praktische Anwendungen

Partielle Klassen sind besonders von Vorteil in Szenarien, die automatisch generierten Quellcode umfassen, wie Formulare, bei denen Visual Studio Windows Forms erstellt. Diese Einrichtung ermöglicht es Entwicklern, UI-Design-Code in einer separaten Quelldatei zu halten, wodurch sie die Klasse erweitern oder ändern können, ohne das ursprüngliche UI-Design zu beeinträchtigen.

In Webanwendungen erleichtern partielle Klassen die Trennung von generiertem Webdienst-Wrapper-Code von benutzerdefinierter Geschäftslogik und stellen sicher, dass Updates der Webdienste keine benutzerdefinierten Änderungen überschreiben. Ähnlich erzeugen in Anwendungen, die LINQ to SQL verwenden, dbml-Dateien partielle Klassendefinitionen, die erweitert werden können, um zusätzliche Funktionalität oder Geschäftslogik ohne Änderung des automatisch generierten Codes einzuschließen.

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

IronPDF ist eine umfassende Bibliothek für .NET, die es Entwicklern ermöglicht, PDF-Dokumente in ihren Anwendungen zu erstellen, zu lesen und zu bearbeiten. Es bietet einen einfachen Ansatz zur Erzeugung von PDFs aus HTML mit IronPDF, URLs, Bildern, ASPX und Text, was es zu einem vielseitigen Werkzeug für Berichterstellung, Dokumentenerzeugung und Web-Inhaltsarchivierung macht. IronPDF besticht durch seine Benutzerfreundlichkeit, da es nur minimalen Aufwand erfordert, um in jedes .NET-Projekt integriert zu werden, einschließlich in C# entwickelten Anwendungen.

Integration von IronPDF mit partiellen Klassen

Um die Integration von IronPDF mit partiellen Klassen zu veranschaulichen, betrachten wir ein Beispiel, bei dem wir eine Webanwendung haben, die Berichte im PDF-Format generiert. Wir teilen die Funktionalität auf partielle Klassendateien auf, um unsere Geschäftslogik von unserer PDF-Erzeugungslogik zu trennen.

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()

Abschluss

Der Einsatz von partiellen Klassen, partiellen Methoden und verschachtelten partiellen Typen in C# bietet Entwicklern ein flexibles und leistungsfähiges Werkzeug zur Codeorganisation und Verwaltung. Durch die Trennung von automatisch generiertem Code von Geschäftslogik, Benutzeroberflächenkontrolldefinitionen und anderen Teilen der Anwendung können Entwickler wartbarere, lesbarere und skalierbarere Anwendungen erstellen.

Durch die Trennung der Belange von Geschäftslogik und PDF-Verarbeitung können Entwickler eine bessere Codeorganisation, Wartbarkeit und Skalierbarkeit erreichen. Die leistungsstarken Funktionen von IronPDF in Kombination mit den organisatorischen Vorteilen partieller Klassen schaffen ein mächtiges Werkzeugsortiment für .NET-Entwickler, die in ihren Projekten mit PDFs arbeiten. Testen Sie IronPDF kostenlos mit der Testversion auf IronPDF. Falls Sie am Kauf interessiert sind, beginnt die Lizenz für IronPDF bei $999.