擴充方法是 C# 的一項強大功能，可讓您在不修改現有類型的原始程式碼的情況下，為其新增新功能。 它們對於讓您的程式碼更具可讀性和可維護性非常有用。 在本指南中，我們將探討延伸方法的基礎知識以及如何實作。

什麼是擴充方法？ 擴充方法是特殊的靜態方法，可以像現有類型的實例方法一樣被呼叫。 它們是一種方便的方法，可以在不改變原始原始程式碼或繼承類別的情況下，為現有的類別新增新方法。 要建立擴充方法，您需要在靜態類別中定義靜態方法。 方法的第一個參數應該是您想要擴充的類型，前綴為 `this` 關鍵字。 這個特殊的關鍵字會告訴 C# 編譯器這是一個擴充方法。 ## 在 C# 中實作擴充方法； 既然我們已經知道什麼是擴充方法，那就來實作一個吧。 想像您有一個字串想要倒轉。 您可以為字串類別建立擴充方法，而不必另外撰寫函式來執行這項工作。 首先，讓我們建立一個新的靜態類，稱為 `StringExtensions` 。 類名稱並不重要，但一般的慣例是使用被擴充類型的名稱，後接 "Extensions"。 在這個類別中，我們將定義一個名為 `Reverse` 的靜態方法： ```csharp 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); } } ``` 在這個範例中，我們建立了一個公共靜態字串方法，名稱為 `Reverse` 且只有一個參數。 字串類型前的 `this` 關鍵字表示這是字串類別的延伸方法。 現在，讓我們看看如何在 `Program` 類中使用這個新的擴充方法： ```csharp 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 } } ``` 請注意，我們不需要建立 `StringExtensions` 類的實例。 相反，我們直接在字串實體上使用 `Reverse` 方法，就像使用實體方法一樣。 ## 擴充方法語法 擴充方法的外觀和行為與實例方法類似，但有幾個重要的差異必須牢記： * 擴充方法無法存取擴充類型的私有成員。 * 他們也不參與繼承或多態性。 * 您不能使用擴充方法覆寫現有的方法。 如果擴充類型有與擴充方法具有相同簽章的方法，則永遠以實例方法為優先。 只有在沒有匹配的實例方法時，才會呼叫擴充方法。 ## 擴充方法的實例 現在我們瞭解了 C# 中延伸方法的基本原理，讓我們來看看一些實際的範例。 ### 字串擴充方法字數 假設您想要計算一個字串的字數。 您可以為字串類別建立 `WordCount` 延伸方法： ```csharp 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; } } ``` 現在，您可以輕鬆地數出像這樣的字串中的字數： ```csharp string text = "Extension methods are awesome!"; int wordCount = text.WordCount(); Console.WriteLine($"The text has {wordCount} words."); // Output: The text has 4 words. ``` ### 可數擴充方法中值 假設您有一個數字集合，您想要計算中間值。 您可以為 `IEnumerable` 建立擴充方法： ```csharp 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 IEnumerablesource) { // 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]; } } } ``` 使用此延伸方法，您可以輕鬆找出集合的中位值： ```csharp int[] numbers = { 5, 3, 9, 1, 4 }; double median = numbers.Median(); Console.WriteLine($"The median value is {median}."); // Output: The median value is 4. ``` ### DateTime 擴充方法 StartOfWeek 比方說，您想要找出某個日期的一周開始時間。 您可以為 `DateTime` 結構建立擴充方法： ```csharp 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; } } ``` 現在，您可以輕鬆找到任何日期的一周開始時間： ```csharp 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. ``` ## 使用 IronPDF 和擴充方法生成 PDF。 在本節中，我們將介紹 IronPDF，這是我們業界領先的、用 C# 產生和處理 PDF 檔案的函式庫。 我們也會看看在使用這個函式庫時，如何利用延伸方法來創造更順暢、更直覺的體驗。 IronPDF 將 HTML 轉換為 PDF 的方式，可保留內容在網頁瀏覽器中的排版與樣式。 這個函式庫可以處理來自檔案、URL 和字串的原始 HTML。 以下是快速概述： ```csharp using IronPdf; class Program { static void Main(string[] args) { var renderer = new ChromePdfRenderer(); // 1. Convert HTML String to PDF var htmlContent = "

Hello, IronPDF!

This is a PDF from an HTML string.

"; 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"); } } ``` ### 建立簡單的 PDF 在深入探討擴充方法之前，我們先來看看如何使用 IronPDF 從 HTML 建立一個簡單的 PDF： ```csharp using IronPdf; class Program { static void Main(string[] args) { var renderer = new ChromePdfRenderer(); var PDF = renderer.RenderHtmlAsPdf("Hello, World!"); PDF.SaveAs("HelloWorld.PDF"); } } ``` 此程式碼片段會以文字"Hello, World!"建立 PDF，並將其儲存至名為"HelloWorld.PDF"的檔案。 ### IronPDF 的擴充方法 現在，讓我們來探討如何使用擴充方法來增強 IronPDF 的功能，使其更容易使用。 舉例來說，我們可以建立一個擴充方法，取得字串類別的實體，並直接從該實體產生 PDF。 ```csharp 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); } } ``` 有了這個擴充方法，我們現在可以直接從字串產生 PDF： ```csharp string html = "

Extension Methods and IronPDF

Generating PDFs has never been easier!

"; html.SaveAsPdf("ExtensionMethodsAndIronPDF.PDF"); ``` ### 從 URL 生成 PDF。 我們可以建立的另一個有用的延伸方法是從 URL 產生 PDF 的方法。 我們可以擴充 `Uri` 類別來達成這個目標： ```csharp 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); } } ``` 現在，我們可以輕鬆地從這樣的 URL 產生 PDF： ```csharp Uri url = new Uri("https://www.ironpdf.com/"); url.SaveAsPdf("UrlToPdf.PDF"); ``` ## 結論 瞧！我們探討了 C# 中擴展方法的概念，學習了如何使用靜態方法和靜態類別來實作擴展方法，並使用各種類型的真實範例。此外，我們還介紹了 IronPDF，這是一個用 C# 產生和處理 PDF 檔案的函式庫。 當您開始同時使用擴充方法和 IronPDF 時，您會發現您的程式碼會變得更乾淨、更易讀、更有效率。 準備好使用 IronPdf 了嗎？ 您可以從我們的 [30天免費試用 IronPDF](trial-license) 開始。 它還可以完全免費用於開發目的，讓您真正能一窺其真面目。 如果您喜歡您所看到的，IronPDF 的許可詳情請見[`liteLicense`](https://ironsoftware.com/suite/)版本。 若想節省更多，請查看 [Iron Software Suite 的購買選項](https://ironsoftware.com/suite/)，您可以用兩個工具的價格獲得全部九個 Iron Software 工具。 祝您編碼愉快！