.NET HELP

C# Optional Parameters (How It Works For Developers)

更新:2025年7月28日

在 C# 中定義可選參數

基本文法

要定義可選參數，需要在方法的聲明中為其指定預設值。此預設值必須是一個常數表達式。以下是如何在方法定義中定義一個帶有一個或多個可選預設參數的方法：

public static void DisplayGreeting(string message, string end = "!")
{
    Console.WriteLine(message + end);
}

public static void DisplayGreeting(string message, string end = "!")
{
    Console.WriteLine(message + end);
}

$vbLabelText $csharpLabel

在上面的程式碼片段中，"end"是一個可選參數，其預設值為"!"。這樣一來，該方法既可以帶第二個參數調用，也可以不帶第二個參數調用。

使用可選參數的方法調用

以下是呼叫上述方法的兩種方式：

static void Main()
{
    DisplayGreeting("Hello"); // Outputs: Hello!
    DisplayGreeting("Hello", "?"); // Outputs: Hello?
}

static void Main()
{
    DisplayGreeting("Hello"); // Outputs: Hello!
    DisplayGreeting("Hello", "?"); // Outputs: Hello?
}

$vbLabelText $csharpLabel

第一次呼叫省略了第二個參數，使用了預設值。第二次呼叫提供了一個特定值，覆蓋了預設值。

利用命名參數和可選參數

C# 中的命名參數和可選參數提高了涉及可選參數的方法呼叫的清晰度。它們允許透過在呼叫中直接命名來指定要賦予值的參數。

使用命名參數的範例

// Named parameters
public static void ConfigureDevice(string deviceName, bool enableLogging = false, int timeout = 30)
{
    Console.WriteLine($"Configuring {deviceName}: Logging={(enableLogging ? "On" : "Off")}, Timeout={timeout}s");
}

// Named parameters
public static void ConfigureDevice(string deviceName, bool enableLogging = false, int timeout = 30)
{
    Console.WriteLine($"Configuring {deviceName}: Logging={(enableLogging ? "On" : "Off")}, Timeout={timeout}s");
}

$vbLabelText $csharpLabel

您可以使用命名參數來指定不按順序的值，或跳過選用參數。

static void Main()
{
    ConfigureDevice("Router", timeout: 60);
}

static void Main()
{
    ConfigureDevice("Router", timeout: 60);
}

$vbLabelText $csharpLabel

此呼叫使用可選參數來指定逾時值，同時使用預設值啟用日誌記錄。

結合固定參數和可選參數

方法可以同時具有必需參數（固定參數）和可選參數。在方法聲明中，必需參數必須始終位於可選參數之前，如下面的程式碼片段所示。

程式碼範例

public static void CreateProfile(string firstName, string lastName, int age = 25, string city = "Unknown")
{
    Console.WriteLine($"Name: {firstName} {lastName}, Age: {age}, City: {city}");
}

public static void CreateProfile(string firstName, string lastName, int age = 25, string city = "Unknown")
{
    Console.WriteLine($"Name: {firstName} {lastName}, Age: {age}, City: {city}");
}

$vbLabelText $csharpLabel

呼叫該方法

static void Main()
{
    CreateProfile("John", "Doe"); // Uses default age and city
    CreateProfile("Jane", "Doe", 30, "New York"); // Specifies all parameters
}

static void Main()
{
    CreateProfile("John", "Doe"); // Uses default age and city
    CreateProfile("Jane", "Doe", 30, "New York"); // Specifies all parameters
}

$vbLabelText $csharpLabel

這種省略參數的靈活性使得同一個方法可以在不同的上下文中使用，而無需多個重載。

預設值必須是常數表達式

可選參數的預設值必須是常數表達式，這些表達式會在編譯時求值。這確保了預設值始終穩定且可預測。

正確使用預設值

public static void SendEmail(string address, string subject = "No Subject", string body = "")
{
    Console.WriteLine($"Sending email to {address}\nSubject: {subject}\nBody: {body}");
}

public static void SendEmail(string address, string subject = "No Subject", string body = "")
{
    Console.WriteLine($"Sending email to {address}\nSubject: {subject}\nBody: {body}");
}

$vbLabelText $csharpLabel

參數重載與可選參數

方法重載涉及為不同的用例建立多個方法簽名，而使用可選參數則允許單一方法處理各種場景。

透過代碼進行比較

重載方法可能如下所示：

// Method overloading
public static void Alert(string message)
{
    Console.WriteLine(message);
}

public static void Alert(string message, bool urgent)
{
    if (urgent)
        Console.WriteLine("Urgent: " + message);
    else
        Console.WriteLine(message);
}

// Method overloading
public static void Alert(string message)
{
    Console.WriteLine(message);
}

public static void Alert(string message, bool urgent)
{
    if (urgent)
        Console.WriteLine("Urgent: " + message);
    else
        Console.WriteLine(message);
}

$vbLabelText $csharpLabel

使用可選參數的等效方法：

public static void Alert(string message, bool urgent = false)
{
    if (urgent)
        Console.WriteLine("Urgent: " + message);
    else
        Console.WriteLine(message);
}

public static void Alert(string message, bool urgent = false)
{
    if (urgent)
        Console.WriteLine("Urgent: " + message);
    else
        Console.WriteLine(message);
}

$vbLabelText $csharpLabel

C# 可選參數（開發者如何理解）：圖 1 - 可選參數輸出

使用可選參數的好處

可選參數簡化了方法接口，減少了對大量重載的需求。它們使方法更加靈活，程式碼庫更容易維護和理解。

可選參數帶來的挑戰

如果過度使用可選參數，可能會導致人們對每個方法的期望和正確執行所需的內容感到困惑。它們可能會掩蓋方法的意圖，尤其是在參數很多或預設值不明確的情況下。

最佳實踐

1.限制可選參數：謹慎使用可選參數，避免方法簽章過於複雜。 2.使用命名參數：提高方法呼叫的清晰度，特別是省略某些可選參數時。 3.記錄預設值：記錄每個參數的作用以及預設值的意義，以防止誤用或混淆。

使用 IronPDF 和 C# 可選參數

C# 可選參數（開發者如何理解）：圖 2 - IronPDF

IronPDF 是一個實用的 .NET 程式庫，它允許開發人員直接在應用程式中建立、操作和渲染 PDF 文件。它可以有效率地將HTML轉換為PDF，用於PDF轉換。 HTML 可以採用多種形式，例如 HTML 字串、HTML 檔案或 URL。它非常適合需要動態產生 PDF 文件的應用，例如發票、報告或自訂使用者內容。透過 IronPDF，開發人員可以充分利用 .NET Framework 來有效率地處理 PDF 文件。

IronPDF 的突出特點是能夠輕鬆地將 HTML 轉換為 PDF ，同時保留佈局和樣式。它非常適合從基於 Web 的內容（例如報告、發票或文件）產生 PDF 文件。您可以使用它將 HTML 檔案、URL 和 HTML 字串轉換為 PDF 檔案。

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");
    }
}

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");
    }
}

$vbLabelText $csharpLabel

將 IronPDF 與 C# 可選參數結合使用，可以簡化產生 PDF 文件的流程。透過使用可選參數，開發人員可以建立靈活的 PDF 生成方法，以適應不同的輸入和要求，同時最大限度地減少方法重載。

程式碼範例

以下範例示範如何使用 IronPDF 和 C# 可選參數，從簡單的 HTML 範本產生自訂 PDF 報告，並可調整標題以及是否包含某些報告部分等詳細資訊：

using IronPdf;
using System;

public class PdfReportGenerator
{
    // Method to generate PDF with optional parameters
    public static void CreatePdfReport(string htmlContent, string filePath = "Report.pdf", bool includeCharts = true, string reportTitle = "Monthly Report")
    {
        // Optional parameters allow customization of the report's title and content dynamically
        var renderer = new ChromePdfRenderer();
        // Customize the PDF document
        renderer.RenderingOptions.TextHeader.CenterText = reportTitle;
        renderer.RenderingOptions.TextFooter.CenterText = "Generated on " + DateTime.Now.ToString("dd-MM-yyyy");
        renderer.RenderingOptions.MarginTop = 50;  // Set the top margin
        renderer.RenderingOptions.MarginBottom = 50;  // Set the bottom margin
        if (!includeCharts)
        {
            // Modify HTML content to remove chart sections if not included
            htmlContent = htmlContent.Replace("<div class='charts'></div>", "");
        }
        // Render the HTML to PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
        // Save the generated PDF to a file
        pdf.SaveAs(filePath);
        Console.WriteLine($"PDF report has been created at {filePath}");
    }

    static void Main()
    {
        License.LicenseKey = "License-Key"; // Specify the license key if required
        string htmlTemplate = @"
        <html>
        <head>
            <title>Monthly Report</title>
        </head>
        <body>
            <h1>Monthly Performance Report</h1>
            <p>This section contains text describing the overall performance for the month.</p>
            <div class='charts'>
                <h2>Sales Charts</h2>

            </div>
        </body>
        </html>";

        // Call the CreatePdfReport method with different parameters
        CreatePdfReport(htmlTemplate, "BasicReport.pdf", false, "Basic Monthly Report");
        CreatePdfReport(htmlTemplate, "FullReport.pdf", true, "Detailed Monthly Report");
    }
}

using IronPdf;
using System;

public class PdfReportGenerator
{
    // Method to generate PDF with optional parameters
    public static void CreatePdfReport(string htmlContent, string filePath = "Report.pdf", bool includeCharts = true, string reportTitle = "Monthly Report")
    {
        // Optional parameters allow customization of the report's title and content dynamically
        var renderer = new ChromePdfRenderer();
        // Customize the PDF document
        renderer.RenderingOptions.TextHeader.CenterText = reportTitle;
        renderer.RenderingOptions.TextFooter.CenterText = "Generated on " + DateTime.Now.ToString("dd-MM-yyyy");
        renderer.RenderingOptions.MarginTop = 50;  // Set the top margin
        renderer.RenderingOptions.MarginBottom = 50;  // Set the bottom margin
        if (!includeCharts)
        {
            // Modify HTML content to remove chart sections if not included
            htmlContent = htmlContent.Replace("<div class='charts'></div>", "");
        }
        // Render the HTML to PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);
        // Save the generated PDF to a file
        pdf.SaveAs(filePath);
        Console.WriteLine($"PDF report has been created at {filePath}");
    }

    static void Main()
    {
        License.LicenseKey = "License-Key"; // Specify the license key if required
        string htmlTemplate = @"
        <html>
        <head>
            <title>Monthly Report</title>
        </head>
        <body>
            <h1>Monthly Performance Report</h1>
            <p>This section contains text describing the overall performance for the month.</p>
            <div class='charts'>
                <h2>Sales Charts</h2>

            </div>
        </body>
        </html>";

        // Call the CreatePdfReport method with different parameters
        CreatePdfReport(htmlTemplate, "BasicReport.pdf", false, "Basic Monthly Report");
        CreatePdfReport(htmlTemplate, "FullReport.pdf", true, "Detailed Monthly Report");
    }
}

$vbLabelText $csharpLabel

以下是完整報告PDF文件的預覽：

C# 可選參數（開發者如何理解）：圖 3 - PDF 報告輸出

程式碼範例中的CreatePdfReport方法旨在從 HTML 內容產生 PDF 文檔，並提供靈活性，可選參數包括文件路徑、圖表包含和報告標題。這種設計使得該方法只需進行少量程式碼調整即可適應不同的報告需求。在該方法中，IronPDF 設定進行了調整，以便在 PDF 中包含自訂頁首和頁腳，這些頁首和頁尾設定為顯示報告標題和報告產生日期。

對頁邊距進行配置，以改善文件的視覺佈局。根據includeCharts參數是真還是假，HTML 內容會動態修改，以包含或排除圖表視覺效果。最後，將可能經過修改的 HTML 檔案轉換為 PDF 檔案並儲存到指定位置。此範例示範了可選參數如何顯著簡化建立客製化 PDF 報告的過程。

結論

C# 可選參數（開發者如何理解）：圖 4 - 許可

總之，可選參數允許開發人員創建更靈活、更易於維護的程式碼，從而減少對多個重載方法的需求。透過將 C# 選用參數與 IronPDF 庫結合使用，開發人員可以有效率地產生自訂 PDF 文件。這種整合不僅簡化了程式碼庫，還增強了功能，使其更容易適應不同的報告要求或使用者偏好。

IronPDF 本身就是一個強大的工具，適用於任何希望將 PDF 功能整合到其應用程式中的 .NET 開發人員，並為希望測試其功能的開發人員提供免費的 IronPDF 試用版。對於持續使用，許可證起價為$799 ，為專業級 PDF 處理提供經濟高效的解決方案。

常見問題解答

C# 中的可選參數是什麼，如何使用？

C# 中的可選參數允許開發人員透過指定某些參數的預設值，定義可以使用較少參數呼叫的方法。這表示如果在方法呼叫中省略了參數，就會使用預設值。

命名參數如何提高 C# 程式碼的可讀性？

命名參數可讓開發人員直接在方法呼叫中指定哪些參數被指定值，從而提高程式碼的可讀性。這在處理有多個參數的方法時特別有用，因為它可以釐清哪些參數對應哪些參數。

C# 中的可選參數與方法重載有何差異？

可選參數允許單一方法處理不同數量的參數，而方法重載涉及使用不同參數創建多個版本的方法。可選參數可避免多重方法定義，從而降低複雜性。

當使用 .NET 函式庫來產生 PDF 時，可選參數如何產生效益？

當使用 .NET 函式庫來產生 PDF 時，可選參數可讓開發人員只指定產生 PDF 所需的參數，進而簡化方法呼叫。這種彈性有助於自訂 PDF 內容、版面和檔案屬性，而不需要多重重載。

在 C# 中使用可選參數的最佳做法是什麼？

使用可選參數的最佳實務包括限制其使用以避免混淆、確保預設值有完善的說明文件，以及將其與命名參數結合使用以改善方法呼叫的清晰度。

結合固定參數和可選參數對方法設計有什麼好處？

結合固定與可選參數，可讓開發人員強制某些輸入，同時為其他輸入提供彈性。此設計策略可確保提供必要的資料，同時簡化方法介面以提供額外的非必要輸入。

如何在 C# 中使用可選參數簡化 PDF 報告的產生？

C# 中的可選參數可以簡化 PDF 報告的產生，讓開發人員只需指定必要的資料，例如標題或作者，而其他參數（例如檔案路徑或頁面配置）則使用預設設定，從而減少對多個方法版本的需求。

Jacob Mellor

立即與工程團隊聊天

首席技術長

Jacob Mellor 是 Iron Software 的首席技術長，也是開創 C# PDF 技術的有遠見的工程師。作為 Iron Software 核心程式碼庫背後的原始開發人員，他從公司成立之初就塑造了公司的產品架構，與首席執行官 Cameron Rimington 一起將公司轉型為一家 50 多人的公司，為 NASA、Tesla 和全球政府機構提供服務。

Jacob 持有曼徹斯特大學土木工程一級榮譽工程學士學位 (BEng)（1998-2001 年）。

Jacob 於 1999 年在倫敦開設了他的第一家軟體公司，並於 2005 年創建了他的第一個 .NET 元件，之後，他專門解決微軟生態系統中的複雜問題。

他的旗艦產品 IronPDF & Iron Suite for .NET 函式庫在全球的 NuGet 安裝量已超過 3000 萬次，他的基礎程式碼持續為全球使用的開發人員工具提供動力。Jacob 擁有 25 年的商業經驗和 41 年的編碼專業知識，他一直專注於推動企業級 C#、Java 和 Python PDF 技術的創新，同時指導下一代的技術領導者。

更新2025年12月11日

Bridging CLI Simplicity & .NET : Using Curl DotNet with IronPDF

Jacob Mellor has bridged this gap with CurlDotNet, a library created to bring the familiarity of cURL to the .NET ecosystem.

更新2025年12月20日

RandomNumberGenerator C#

Using the RandomNumberGenerator C# class can help take your PDF generation and editing projects to the next level

更新2025年12月20日

C# String Equals (How it Works for Developers)

When combined with a powerful PDF library like IronPDF, switch pattern matching allows you to build smarter, cleaner logic for document processing

Resharper C# (How It Works For Deve...

客戶亮點：

開發者焦點：

網絡研討會：

開始 30 天免費試用

C# Optional Parameters (How It Works For Developers)

在 C# 中定義可選參數

基本文法

使用可選參數的方法調用

利用命名參數和可選參數

使用命名參數的範例

結合固定參數和可選參數

程式碼範例

呼叫該方法

預設值必須是常數表達式

正確使用預設值

參數重載與可選參數

透過代碼進行比較

使用可選參數的好處

可選參數帶來的挑戰

最佳實踐

使用 IronPDF 和 C# 可選參數

程式碼範例

結論

常見問題解答

C# 中的可選參數是什麼，如何使用？

命名參數如何提高 C# 程式碼的可讀性？

C# 中的可選參數與方法重載有何差異？

當使用 .NET 函式庫來產生 PDF 時，可選參數如何產生效益？

在 C# 中使用可選參數的最佳做法是什麼？

結合固定參數和可選參數對方法設計有什麼好處？

如何在 C# 中使用可選參數簡化 PDF 報告的產生？

開始 30 天免費試用

C# Optional Parameters (How It Works For Developers)

在 C# 中定義可選參數

基本文法

使用可選參數的方法調用

利用命名參數和可選參數

使用命名參數的範例

結合固定參數和可選參數

程式碼範例

呼叫該方法

預設值必須是常數表達式

正確使用預設值

參數重載與可選參數

透過代碼進行比較

使用可選參數的好處

可選參數帶來的挑戰

最佳實踐

使用 IronPDF 和 C# 可選參數

程式碼範例

結論

常見問題解答

C# 中的可選參數是什麼，如何使用？

命名參數如何提高 C# 程式碼的可讀性？

C# 中的可選參數與方法重載有何差異？

當使用 .NET 函式庫來產生 PDF 時，可選參數如何產生效益？

在 C# 中使用可選參數的最佳做法是什麼？

結合固定參數和可選參數對方法設計有什麼好處？

如何在 C# 中使用可選參數簡化 PDF 報告的產生？

相關文章

Bridging CLI Simplicity & .NET : Using Curl DotNet with IronPDF

RandomNumberGenerator C#

C# String Equals (How it Works for Developers)

下一步：開始免費 30 天試用

下一步：開始免費 30 天試用

深受全球數百萬工程師信賴