.NET 幫助

C# 雙問號（它如何為開發人員工作）

發佈 2024年1月14日

在 C# 程式設計中，有效處理空值是一個常見的挑戰。輸入雙問號運算子(??)，一項強大的功能，設計用來簡化空合併運算子。新的開發者常常對於這個雙問號運算符的意義感到疑惑。查看此來源以獲得更準確的答案：理解 C# 中的兩個問號

在本文中，我們將深入探討 C# 雙問號運算子的複雜性，探索其功能、使用情境及其如何改變開發人員在代碼中處理空值的方式。

理解基礎知識：C# 中的空合併運算子

空合併是一種程式設計概念，是指在遇到空引用時指派預設值。傳統上，開發人員使用條件運算符或三元運算符來實現空合併。 C# 的空合併運算子提供了一種更簡潔且更具表達力的方式來處理這些情況。

??的本質

空合併運算子(??)是一個二元運算符，如果左操作數不為 null，則返回左操作數；否則，返回右邊的運算元。它提供了一種簡潔的語法，用於在處理可空類型或潛在的空引用時提供預設的非空值。

簡單的使用和語法

空合併賦值運算子的基本語法是將 ?? 放置在兩個表達式之間。這是一個簡單的例子：

int? nullableValue = possiblyNullInt ?? defaultValue;

int? nullableValue = possiblyNullInt ?? defaultValue;

Dim nullableValue? As Integer = If(possiblyNullInt, defaultValue)

VB C#

在這種情況下，如果 possiblyNullInt 不為 null，nullableValue 將取其值。否則，將默認為指定的defaultValue。對於那些對 nullableValue 的變數類型感到好奇的人來說，這是一個可空類型的值。這意味著nullableValue也可以被設置為一個空值，這對於普通的整數而言是不可能的，因為它會簡單地返回為一個缺失值。

簡化 Null 檢查

空合併運算子的主要優勢之一在於它能夠簡化空值檢查，使代碼更加簡潔和易讀。考慮以下沒有操作員的情況：

string result;
if (possiblyNullString != null)
{
    result = possiblyNullString;
}
else
{
    result = "DefaultValue";
}

string result;
if (possiblyNullString != null)
{
    result = possiblyNullString;
}
else
{
    result = "DefaultValue";
}

Dim result As String
If possiblyNullString IsNot Nothing Then
	result = possiblyNullString
Else
	result = "DefaultValue"
End If

VB C#

使用雙問號運算符，等效的代碼變為：

string result = possiblyNullString ?? "DefaultValue";

string result = possiblyNullString ?? "DefaultValue";

Dim result As String = If(possiblyNullString, "DefaultValue")

VB C#

這種樣板代碼的減少提高了代碼的清晰度，並減少了與空值相關的錯誤機會。

連鎖運算符用於預設值

雙問號運算子可以連鎖來提供一系列備援值，使得預設值可以有級聯的方法。

int result = possiblyNullInt ?? fallbackInt ?? 0;

int result = possiblyNullInt ?? fallbackInt ?? 0;

Dim result As Integer = If(If(possiblyNullInt, fallbackInt), 0)

VB C#

在此範例中，如果 possiblyNullInt 為空值，運算子將檢查 fallbackInt。如果兩者皆為空，最終的備援是。這意味著結果不必是一種可空類型，因為回退始終是整數。

方法參數中的應用

雙問號運算符在為方法參數指定預設值時特別有用。

public void PrintMessage(string message = null)
{
    string defaultMessage = "Default Message";
    string finalMessage = message ?? defaultMessage;
    Console.WriteLine(finalMessage);
}

public void PrintMessage(string message = null)
{
    string defaultMessage = "Default Message";
    string finalMessage = message ?? defaultMessage;
    Console.WriteLine(finalMessage);
}

Public Sub PrintMessage(Optional ByVal message As String = Nothing)
	Dim defaultMessage As String = "Default Message"
	Dim finalMessage As String = If(message, defaultMessage)
	Console.WriteLine(finalMessage)
End Sub

VB C#

在這個方法中，如果 message 為空，將使用預設值 "Default Message"。

與三元運算子的集成

雙問號運算子可以與三元運算子結合使用(？ :)用於更進階的條件處理。

int? nullableValue = possiblyNullInt ?? (anotherNullableInt.HasValue ? anotherNullableInt.Value : 0);

int? nullableValue = possiblyNullInt ?? (anotherNullableInt.HasValue ? anotherNullableInt.Value : 0);

Dim nullableValue? As Integer = If(possiblyNullInt, (If(anotherNullableInt.HasValue, anotherNullableInt.Value, 0)))

VB C#

在這裡，如果 possiblyNullInt 為空，則檢查 anotherNullableInt 是否有值。如果是，則使用該值；否則，它默認為。

介紹 IronPDF

掌握使用IronPDF生成PDF是一個多功能的C#庫，旨在簡化處理PDF的複雜性。無論您是在生成發票、報告或任何其他文件，IronPDF 都可以讓您在 C# 應用程式中將 HTML 內容無縫轉換為精美且專業的 PDF。

IronPDF 的主要功能是其HTML 轉換為 PDF 工具，確保佈局和樣式保持不變。它從網頁內容生成 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");
    }
}

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 Class

VB C#

C# 雙問號（它對開發者的工作原理）：圖 1 - IronPDF 頁面

安裝 IronPDF：快速入門

要將 IronPDF 整合到您的 C# 專案中，首先安裝 IronPDF NuGet 套件。在您的套件管理器控制台中執行以下命令：

Install-Package IronPdf

或者，在 NuGet 套件管理器中找到 "IronPDF"，然後從那裡進行安裝。

使用 IronPDF 生成 PDF

使用 IronPDF 創建 PDF 是一個簡單的過程。請考慮以下示例：

var htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
// Create a new PDF document
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("C:/GeneratedDocument.pdf");

var htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
// Create a new PDF document
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("C:/GeneratedDocument.pdf");

Dim htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>"
' Create a new PDF document
Dim pdfDocument = New IronPdf.ChromePdfRenderer()
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("C:/GeneratedDocument.pdf")

VB C#

在此範例中，IronPDF 被用於將 HTML 內容渲染成 PDF 文件，然後儲存到指定的位置。訪問此頁面探索 IronPDF 代碼範例資源用於更多創建 PDF 文件的方法。

C# 雙問號運算符：巧妙地處理預設值

雙問號運算子(??)在 C# 中，是一種處理可空類型並在必要時提供預設值的強大工具。讓我們探索如何將這個運算子無縫整合到 IronPDF 中，以增強具有非空值型別的文件生成場景。

與 IronPDF 配置的整合

考慮一種需要為 IronPDF 設定預設配置的情況，例如頁面大小或邊距。雙問號運算子可以用來提供當特定配置未明確定義時的預設值。

var customPageSize = GetUserDefinedPageSize(); // Assume this method might return null
var defaultRenderOptions = new ChromePdfRenderOptions();
defaultRenderOptions.PaperSize = customPageSize ?? IronPdf.Rendering.PdfPaperSize.A4;
// Create a new PDF document with optional custom page size
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderingOptions = defaultRenderingOptions;
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("GeneratedDocument.pdf");

var customPageSize = GetUserDefinedPageSize(); // Assume this method might return null
var defaultRenderOptions = new ChromePdfRenderOptions();
defaultRenderOptions.PaperSize = customPageSize ?? IronPdf.Rendering.PdfPaperSize.A4;
// Create a new PDF document with optional custom page size
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderingOptions = defaultRenderingOptions;
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("GeneratedDocument.pdf");

Dim customPageSize = GetUserDefinedPageSize() ' Assume this method might return null
Dim defaultRenderOptions = New ChromePdfRenderOptions()
defaultRenderOptions.PaperSize = If(customPageSize, IronPdf.Rendering.PdfPaperSize.A4)
' Create a new PDF document with optional custom page size
Dim pdfDocument = New IronPdf.ChromePdfRenderer()
pdfDocument.RenderingOptions = defaultRenderingOptions
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("GeneratedDocument.pdf")

VB C#

在這個範例中，如果 GetUserDefinedPageSize() 返回 null，即使用預設的 A4 頁面大小。

使用預設文字進行動態內容生成

假設您正在動態生成 PDF 的內容，並且某些文本元素可能為 null。雙問號運算子可以用來優雅地處理空值並提供預設文本。

string dynamicHeaderText = GetDynamicHeaderText(); // Assume this method might return null
string headerText = dynamicHeaderText ?? "Hello World!";
// Incorporate the header text into HTML content
var dynamicHtmlContent = $@"
    <html>
    <body>
        <h1>{headerText}</h1>
        <!-- Other dynamic content -->
    </body>
    </html>
";
// Create a new PDF document with dynamic content
var dynamicPdfDocument = new IronPdf.ChromePdfRenderer();
dynamicPdfDocument.RenderHtmlAsPdf(dynamicHtmlContent).SaveAs("DynamicDocument.pdf");

string dynamicHeaderText = GetDynamicHeaderText(); // Assume this method might return null
string headerText = dynamicHeaderText ?? "Hello World!";
// Incorporate the header text into HTML content
var dynamicHtmlContent = $@"
    <html>
    <body>
        <h1>{headerText}</h1>
        <!-- Other dynamic content -->
    </body>
    </html>
";
// Create a new PDF document with dynamic content
var dynamicPdfDocument = new IronPdf.ChromePdfRenderer();
dynamicPdfDocument.RenderHtmlAsPdf(dynamicHtmlContent).SaveAs("DynamicDocument.pdf");

Dim dynamicHeaderText As String = GetDynamicHeaderText() ' Assume this method might return null
Dim headerText As String = If(dynamicHeaderText, "Hello World!")
' Incorporate the header text into HTML content
Dim dynamicHtmlContent = $"
    <html>
    <body>
        <h1>{headerText}</h1>
        <!-- Other dynamic content -->
    </body>
    </html>
"
' Create a new PDF document with dynamic content
Dim dynamicPdfDocument = New IronPdf.ChromePdfRenderer()
dynamicPdfDocument.RenderHtmlAsPdf(dynamicHtmlContent).SaveAs("DynamicDocument.pdf")

VB C#

在這裡，如果GetDynamicHeaderText() 返回空值，標題文字預設為「Hello World」!PDF 中的否則，文字來自 GetDynamicHeaderText() 方法已儲存。

C# 雙問號（其對開發者的作用）：圖 2 - 上述代碼的默認標題