Erweiterungsmethoden sind ein leistungsstarkes Feature in C#, mit dem Sie bestehenden Typen neue Funktionen hinzufügen können, ohne deren Quellcode zu ändern. Sie können äußerst nützlich sein, um Ihren Code lesbarer und wartbarer zu machen. In diesem Leitfaden werden wir die Grundlagen von Erweiterungsmethoden und deren Implementierung erkunden.
Erweiterungsmethoden sind spezielle statische Methoden, die aufgerufen werden können, als ob sie Instanzmethoden eines bestehenden Typs wären. Sie sind eine bequeme Möglichkeit, einer bestehenden Klasse ohne Änderung des ursprünglichen Quellcodes oder Vererbung von der Klasse neue Methoden hinzuzufügen.
Um eine Erweiterungsmethode zu erstellen, müssen Sie eine statische Methode in einer statischen Klasse definieren. Der erste Parameter der Methode sollte der Typ sein, den Sie erweitern möchten, mit dem Schlüsselwort this als Präfix. Dieses spezielle Schlüsselwort teilt dem C#-Compiler mit, dass es sich um eine Erweiterungsmethode handelt.
Nun, da wir wissen, was Erweiterungsmethoden sind, lassen Sie uns eine implementieren. Stellen Sie sich vor, Sie haben einen String, den Sie umkehren möchten. Statt eine separate Funktion dafür zu schreiben, können Sie eine Erweiterungsmethode für die String-Klasse erstellen.
Zuerst erstellen wir eine neue statische Klasse namens StringExtensions. Der Klassenname ist nicht wichtig, aber es ist eine übliche Konvention, den Namen des erweiterten Typs gefolgt von "Extensions" zu verwenden. In dieser Klasse definieren wir eine statische Methode namens Reverse:
public static class StringExtensions
{
// This extension method reverses a given string.
public static string Reverse(this string input)
{
// Convert the string to a character array.
char[] chars = input.ToCharArray();
// Reverse the array in place.
Array.Reverse(chars);
// Create a new string from the reversed character array and return it.
return new string(chars);
}
}Public Module StringExtensions
' This extension method reverses a given string.
<System.Runtime.CompilerServices.Extension> _
Public Function Reverse(ByVal input As String) As String
' Convert the string to a character array.
Dim chars() As Char = input.ToCharArray()
' Reverse the array in place.
Array.Reverse(chars)
' Create a new string from the reversed character array and return it.
Return New String(chars)
End Function
End ModuleIn diesem Beispiel haben wir eine öffentliche statische String-Methode namens Reverse mit einem einzelnen Parameter erstellt. Das Schlüsselwort this vor dem String-Typ zeigt an, dass dies eine Erweiterungsmethode für die String-Klasse ist.
Nun sehen wir, wie diese neue Erweiterungsmethode in unserer Program Klasse verwendet wird:
class Program
{
static void Main(string[] args)
{
string example = "Hello, World!";
// Call the extension method as if it were an instance method.
string reversed = example.Reverse();
Console.WriteLine(reversed); // Output: !dlroW ,olleH
}
}Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim example As String = "Hello, World!"
' Call the extension method as if it were an instance method.
Dim reversed As String = example.Reverse()
Console.WriteLine(reversed) ' Output: !dlroW ,olleH
End Sub
End ClassBeachten Sie, dass wir keine Instanz der StringExtensions Klasse erstellen mussten. Stattdessen haben wir die Reverse Methode direkt auf der String-Instanz verwendet, als ob sie eine Instanzmethode wäre.
Erweiterungsmethoden sehen aus und verhalten sich wie Instanzmethoden, aber es gibt einige wichtige Unterschiede zu beachten:
Wenn der erweiterte Typ eine Methode mit derselben Signatur wie eine Erweiterungsmethode hat, hat die Instanzmethode immer Vorrang. Erweiterungsmethoden werden nur aufgerufen, wenn keine passende Instanzmethode vorhanden ist.
Jetzt, da wir die Grundlagen von Erweiterungsmethoden in C# verstanden haben, schauen wir uns einige Beispiele aus dem wirklichen Leben an.
Stellen Sie sich vor, Sie möchten die Anzahl der Wörter in einem String zählen. Sie können eine WordCount Erweiterungsmethode für die String-Klasse erstellen:
public static class StringExtensions
{
// This extension method counts the number of words in a string.
public static int WordCount(this string input)
{
// Split the string by whitespace characters and return the length of the resulting array.
return input.Split(new[] { ' ', '\t', '\r', '\n' }, StringSplitOptions.RemoveEmptyEntries).Length;
}
}Imports Microsoft.VisualBasic
Public Module StringExtensions
' This extension method counts the number of words in a string.
<System.Runtime.CompilerServices.Extension> _
Public Function WordCount(ByVal input As String) As Integer
' Split the string by whitespace characters and return the length of the resulting array.
Return input.Split( { " "c, ControlChars.Tab, ControlChars.Cr, ControlChars.Lf }, StringSplitOptions.RemoveEmptyEntries).Length
End Function
End ModuleJetzt können Sie die Anzahl der Wörter in einem String einfach so zählen:
string text = "Extension methods are awesome!";
int wordCount = text.WordCount();
Console.WriteLine($"The text has {wordCount} words."); // Output: The text has 4 words.Dim text As String = "Extension methods are awesome!"
Dim wordCount As Integer = text.WordCount()
Console.WriteLine($"The text has {wordCount} words.") ' Output: The text has 4 words.Angenommen, Sie haben eine Sammlung von Zahlen und möchten den Medianwert berechnen. Sie können eine Erweiterungsmethode für IEnumerable<int> erstellen:
using System;
using System.Collections.Generic;
using System.Linq;
public static class EnumerableExtensions
{
// This extension method calculates the median of a collection of integers.
public static double Median(this IEnumerable<int> source)
{
// Sort the collection and convert it to an array.
int[] sorted = source.OrderBy(x => x).ToArray();
int count = sorted.Length;
if (count == 0)
{
throw new InvalidOperationException("The collection is empty.");
}
// If the count is even, return the average of the two middle elements.
if (count % 2 == 0)
{
return (sorted[count / 2 - 1] + sorted[count / 2]) / 2.0;
}
else
{
// Otherwise, return the middle element.
return sorted[count / 2];
}
}
}Imports System
Imports System.Collections.Generic
Imports System.Linq
Public Module EnumerableExtensions
' This extension method calculates the median of a collection of integers.
<System.Runtime.CompilerServices.Extension> _
Public Function Median(ByVal source As IEnumerable(Of Integer)) As Double
' Sort the collection and convert it to an array.
Dim sorted() As Integer = source.OrderBy(Function(x) x).ToArray()
Dim count As Integer = sorted.Length
If count = 0 Then
Throw New InvalidOperationException("The collection is empty.")
End If
' If the count is even, return the average of the two middle elements.
If count Mod 2 = 0 Then
Return (sorted(count \ 2 - 1) + sorted(count \ 2)) / 2.0
Else
' Otherwise, return the middle element.
Return sorted(count \ 2)
End If
End Function
End ModuleMit dieser Erweiterungsmethode können Sie den Medianwert einer Sammlung leicht finden:
int[] numbers = { 5, 3, 9, 1, 4 };
double median = numbers.Median();
Console.WriteLine($"The median value is {median}."); // Output: The median value is 4.Dim numbers() As Integer = { 5, 3, 9, 1, 4 }
Dim median As Double = numbers.Median()
Console.WriteLine($"The median value is {median}.") ' Output: The median value is 4.Angenommen, Sie möchten den Beginn der Woche für ein bestimmtes Datum finden. Sie können eine Erweiterungsmethode für die DateTime Struktur erstellen:
public static class DateTimeExtensions
{
// This extension method calculates the start of the week for a given date.
public static DateTime StartOfWeek(this DateTime dt, DayOfWeek startOfWeek = DayOfWeek.Monday)
{
// Calculate the difference in days between the current day and the start of the week.
int diff = (7 + (dt.DayOfWeek - startOfWeek)) % 7;
// Subtract the difference to get the start of the week.
return dt.AddDays(-1 * diff).Date;
}
}Public Module DateTimeExtensions
' This extension method calculates the start of the week for a given date.
'INSTANT VB NOTE: The parameter startOfWeek was renamed since Visual Basic will not allow parameters with the same name as their enclosing function or property:
<System.Runtime.CompilerServices.Extension> _
Public Function StartOfWeek(ByVal dt As DateTime, Optional ByVal startOfWeek_Conflict As DayOfWeek = DayOfWeek.Monday) As DateTime
' Calculate the difference in days between the current day and the start of the week.
Dim diff As Integer = (7 + (dt.DayOfWeek - startOfWeek_Conflict)) Mod 7
' Subtract the difference to get the start of the week.
Return dt.AddDays(-1 * diff).Date
End Function
End ModuleJetzt können Sie den Beginn der Woche für jedes Datum einfach finden:
DateTime today = DateTime.Today;
DateTime startOfWeek = today.StartOfWeek();
Console.WriteLine($"The start of the week is {startOfWeek.ToShortDateString()}.");
// Output will depend on the current date, e.g. The start of the week is 17/06/2024.Dim today As DateTime = DateTime.Today
Dim startOfWeek As DateTime = today.StartOfWeek()
Console.WriteLine($"The start of the week is {startOfWeek.ToShortDateString()}.")
' Output will depend on the current date, e.g. The start of the week is 17/06/2024.In diesem Abschnitt stellen wir IronPDF vor, unsere branchenführende Bibliothek zur Erstellung und Bearbeitung von PDF-Dateien in C#. Wir werden auch sehen, wie wir Erweiterungsmethoden nutzen können, um ein nahtloseres und intuitiveres Erlebnis bei der Arbeit mit dieser Bibliothek zu schaffen.
IronPDF konvertiert HTML in PDF auf eine Weise, die Layout und Stil des Inhalts bewahrt, wie es in einem Webbrowser erscheinen würde. Die Bibliothek kann mit rohem HTML aus Dateien, URLs und Strings arbeiten. Hier ist eine kurze Übersicht:
using IronPdf;
class Program
{
static void Main(string[] args)
{
var renderer = new ChromePdfRenderer();
// 1. Convert HTML String to PDF
var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");
// 2. Convert HTML File to PDF
var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");
// 3. Convert URL to PDF
var url = "http://ironpdf.com"; // Specify the URL
var pdfFromUrl = renderer.RenderUrlAsPdf(url);
pdfFromUrl.SaveAs("URLToPDF.pdf");
}
}Imports IronPdf
Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim renderer = New ChromePdfRenderer()
' 1. Convert HTML String to PDF
Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")
' 2. Convert HTML File to PDF
Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")
' 3. Convert URL to PDF
Dim url = "http://ironpdf.com" ' Specify the URL
Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
pdfFromUrl.SaveAs("URLToPDF.pdf")
End Sub
End ClassBevor wir uns mit Erweiterungsmethoden befassen, lassen Sie uns sehen, wie man ein einfaches PDF aus HTML mit IronPDF erstellt:
using IronPdf;
class Program
{
static void Main(string[] args)
{
var renderer = new ChromePdfRenderer();
var PDF = renderer.RenderHtmlAsPdf("Hello, World!");
PDF.SaveAs("HelloWorld.PDF");
}
}Imports IronPdf
Friend Class Program
Shared Sub Main(ByVal args() As String)
Dim renderer = New ChromePdfRenderer()
Dim PDF = renderer.RenderHtmlAsPdf("Hello, World!")
PDF.SaveAs("HelloWorld.PDF")
End Sub
End ClassDieses Code-Snippet erstellt ein PDF mit dem Text "Hallo, Welt!" und speichert es unter dem Namen "HelloWorld.PDF".
Jetzt, lassen Sie uns untersuchen, wie wir Erweiterungsmethoden verwenden können, um die Funktionalität von IronPDF zu verbessern und die Arbeit damit zu erleichtern. Zum Beispiel können wir eine Erweiterungsmethode erstellen, die eine Instanz der String-Klasse nimmt und direkt daraus ein PDF generiert.
using IronPdf;
public static class StringExtensions
{
// This extension method converts a string containing HTML to a PDF and saves it.
public static void SaveAsPdf(this string htmlContent, string filePath)
{
var renderer = new ChromePdfRenderer();
var PDF = renderer.RenderHtmlAsPdf(htmlContent);
PDF.SaveAs(filePath);
}
}Imports IronPdf
Public Module StringExtensions
' This extension method converts a string containing HTML to a PDF and saves it.
<System.Runtime.CompilerServices.Extension> _
Public Sub SaveAsPdf(ByVal htmlContent As String, ByVal filePath As String)
Dim renderer = New ChromePdfRenderer()
Dim PDF = renderer.RenderHtmlAsPdf(htmlContent)
PDF.SaveAs(filePath)
End Sub
End ModuleMit dieser Erweiterungsmethode können wir jetzt direkt aus einem String ein PDF generieren:
string html = "<h1>Extension Methods and IronPDF</h1><p>Generating PDFs has never been easier!</p>";
html.SaveAsPdf("ExtensionMethodsAndIronPdf.PDF");Dim html As String = "<h1>Extension Methods and IronPDF</h1><p>Generating PDFs has never been easier!</p>"
html.SaveAsPdf("ExtensionMethodsAndIronPdf.PDF")Eine weitere nützliche Erweiterungsmethode, die wir erstellen können, ist eine, die ein PDF aus einer URL generiert. Wir können die Uri Klasse erweitern, um dies zu erreichen:
using IronPdf;
public static class UriExtensions
{
// This extension method converts a web URL to a PDF and saves it.
public static void SaveAsPdf(this Uri url, string filePath)
{
var renderer = new ChromePdfRenderer();
var PDF = renderer.RenderUrlAsPdf(url.AbsoluteUri);
PDF.SaveAs(filePath);
}
}Imports IronPdf
Public Module UriExtensions
' This extension method converts a web URL to a PDF and saves it.
<System.Runtime.CompilerServices.Extension> _
Public Sub SaveAsPdf(ByVal url As Uri, ByVal filePath As String)
Dim renderer = New ChromePdfRenderer()
Dim PDF = renderer.RenderUrlAsPdf(url.AbsoluteUri)
PDF.SaveAs(filePath)
End Sub
End ModuleJetzt können wir leicht ein PDF aus einer URL folgendermaßen erstellen:
Uri url = new Uri("https://www.ironpdf.com/");
url.SaveAsPdf("UrlToPdf.PDF");Dim url As New Uri("https://www.ironpdf.com/")
url.SaveAsPdf("UrlToPdf.PDF")Und voila - wir haben das Konzept der Erweiterungsmethoden in C# erkundet, gelernt, wie man sie mit statischen Methoden und statischen Klassen implementiert, und reale Beispiele für verschiedene Typen verwendet. Darüber hinaus haben wir IronPDF eingeführt, eine Bibliothek zur Erstellung und Bearbeitung von PDF-Dateien in C#. Wenn Sie beginnen, Erweiterungsmethoden und IronPDF zusammen zu verwenden, werden Sie sehen, wie viel sauberer, lesbarer und effizienter Ihr Code werden kann.
Bereit, IronPDF selbst auszuprobieren? Sie können mit unserer 30-tägigen kostenlosen Testversion von IronPDF beginnen. Es ist auch völlig kostenlos für Entwicklungszwecke, sodass Sie wirklich sehen können, woraus es besteht. Und wenn Ihnen gefällt, was Sie sehen, beginnt IronPDF schon ab liteLicense für Informationen zur IronPDF-Lizenzierung. Für noch größere Einsparungen werfen Sie einen Blick auf die Kaufoptionen für die Iron Software Suite, bei denen Sie alle neun Iron Software-Tools zum Preis von zwei erhalten können. Viel Spaß beim Coden!
Jacob Mellor ist Chief Technology Officer bei Iron Software und ein visionärer Ingenieur, der Pionierarbeit in der C# PDF-Technologie leistet. Als der ursprüngliche Entwickler hinter der Kern-Codebasis von Iron Software hat er die Produktarchitektur des Unternehmens seit seiner Gründung geprägt und es zusammen mit CEO Cameron Rimington in ein Unternehmen mit mehr als 50 Mitarbeitern verwandelt, das die NASA, Tesla und globale Regierungsbehörden beliefert.
IronPDF ist ein Teil der IRONSUITE
10 .NET-API-Produkte für Ihre Bürodokumente
Wenn Ihr PDF wie HTML aussehen soll, schnell.
