.NET 幫助

Null 合併運算子 C#（開發人員如何使用）

發佈 2024年1月14日

在不斷增長的 C# 程式設計領域中，開發人員經常面臨處理可空值類型的常見挑戰。為了解決這個問題，C# 提供了一個優雅的解決方案——空值合併運算子 (??).

在本文中，我們將探索使用空合併運算子的細微差別，理解其功能、使用案例，以及它如何改變您在 C# 代碼中處理可空類型值的方式。

瞭解空合併運算子

空合併運算子(??)或 Null 條件運算子是 C# 中一個簡潔且強大的二元運算子，旨在簡化空值處理。它提供了一種簡潔的語法，用於在遇到可為空或引用類型時選擇默認值，減少了冗長的空檢查的需要。

基礎知識：語法和用法

空合併運算子的語法很簡單。它包含兩個連續的問號(??). 運算子被用於在左側表達式計算為 null 時提供預設值。

string name = possiblyNullName ?? "DefaultName";

string name = possiblyNullName ?? "DefaultName";

Dim name As String = If(possiblyNullName, "DefaultName")

VB C#

在此範例中，如果 possiblyNullName 為 null，變數 name 將被賦予值 "DefaultName"。

簡化 Null 檢查

空合併運算子的主要優勢之一是其簡化空值檢查的能力，只允許不可為 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#

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

連鎖空值合併運算子以取得預設值

可空合併運算符可以鏈接提供一系列的回退值，允許採用默認值的層遞方法。

string result = possiblyNullString ?? fallbackString ?? "DefaultValue";

string result = possiblyNullString ?? fallbackString ?? "DefaultValue";

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

VB C#

在此範例中，如果 possiblyNullString 為 null，運算子會檢查 fallbackString。如果兩者皆為 null，最終的後備選擇是「DefaultValue」。

方法參數中的應用

空合併運算子在為方法參數指定默認值時特別有用。

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 是否有值。如果是，則使用該值；否則，預設為 0。

介紹 IronPDF：C# PDF 強大工具

Null 合併運算子 C#（對於開發人員來說如何運作）：圖 1 - IronPDF 網頁

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

安裝 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("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("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("GeneratedDocument.pdf")

VB C#

在這個範例中，IronPDF 被用於渲染HTML 轉換為 PDF內容轉換為 PDF 文件，然後保存到指定位置。

空合併運算子的整合與IronPDF

雖然空合運算子主要是用於處理各種情境中的空值，包括變量賦值和方法參數，但它與IronPDF的直接整合可能不是常見的使用案例。 IronPDF 專注於文件生成，而空合併操作更適用於需要預設值的情境。

但是，開發人員在處理與 IronPDF 操作相關的變數或參數時，可以利用空合併運算符。例如，在設定配置或處理可選參數時，可以使用運算子來提供預設值。前面的例子強調了使用空合併運算子以避免任何空引用類型錯誤的重要性：

var defaultRenderOptions = new ChromePdfRenderOptions();
defaultRenderOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
defaultRenderOptions.MarginTop = 20; // Set top margin in millimeters
defaultRenderOptions.MarginBottom = 20; // Set bottom margin in millimeters
defaultRenderOptions.MarginLeft = 10; // Set left margin in millimeters
defaultRenderOptions.MarginRight = 10; // Set right margin in millimeters
defaultRenderOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen; // Set CSS media type
defaultRenderOptions.PrintHtmlBackgrounds = true; // Enable printing of background elements
defaultRenderOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "Page {page} of {total-pages}", // Set center header text
    DrawDividerLine = true // Draw a divider line between the header and content
};
// Function to get user-provided renderOptions
ChromePdfRenderOptions GetUserProvidedRenderOptions()
{
    // Replace this with your logic to retrieve user-provided renderOptions
    return null; // For demonstration purposes, returning null to simulate no user input
}
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderingOptions = GetUserProvidedRenderOptions() ?? defaultRenderOptions;
pdfDocument.RenderUrlAsPdf("https://ironpdf.com").SaveAs("CustomizedDocument.pdf");

var defaultRenderOptions = new ChromePdfRenderOptions();
defaultRenderOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
defaultRenderOptions.MarginTop = 20; // Set top margin in millimeters
defaultRenderOptions.MarginBottom = 20; // Set bottom margin in millimeters
defaultRenderOptions.MarginLeft = 10; // Set left margin in millimeters
defaultRenderOptions.MarginRight = 10; // Set right margin in millimeters
defaultRenderOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen; // Set CSS media type
defaultRenderOptions.PrintHtmlBackgrounds = true; // Enable printing of background elements
defaultRenderOptions.TextHeader = new TextHeaderFooter
{
    CenterText = "Page {page} of {total-pages}", // Set center header text
    DrawDividerLine = true // Draw a divider line between the header and content
};
// Function to get user-provided renderOptions
ChromePdfRenderOptions GetUserProvidedRenderOptions()
{
    // Replace this with your logic to retrieve user-provided renderOptions
    return null; // For demonstration purposes, returning null to simulate no user input
}
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderingOptions = GetUserProvidedRenderOptions() ?? defaultRenderOptions;
pdfDocument.RenderUrlAsPdf("https://ironpdf.com").SaveAs("CustomizedDocument.pdf");

Dim defaultRenderOptions = New ChromePdfRenderOptions()
defaultRenderOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
defaultRenderOptions.MarginTop = 20 ' Set top margin in millimeters
defaultRenderOptions.MarginBottom = 20 ' Set bottom margin in millimeters
defaultRenderOptions.MarginLeft = 10 ' Set left margin in millimeters
defaultRenderOptions.MarginRight = 10 ' Set right margin in millimeters
defaultRenderOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Screen ' Set CSS media type
defaultRenderOptions.PrintHtmlBackgrounds = True ' Enable printing of background elements
defaultRenderOptions.TextHeader = New TextHeaderFooter With {
	.CenterText = "Page {page} of {total-pages}",
	.DrawDividerLine = True
}
' Function to get user-provided renderOptions
'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'ChromePdfRenderOptions GetUserProvidedRenderOptions()
'{
'	' Replace this with your logic to retrieve user-provided renderOptions
'	Return Nothing; ' For demonstration purposes, returning null to simulate no user input
'}
Dim pdfDocument = New IronPdf.ChromePdfRenderer()
pdfDocument.RenderingOptions = If(GetUserProvidedRenderOptions(), defaultRenderOptions)
pdfDocument.RenderUrlAsPdf("https://ironpdf.com").SaveAs("CustomizedDocument.pdf")

VB C#

在此範例中，GetUserProvidedRenderOptions() 函數是一個用於獲取用戶提供的邏輯的佔位符PDF 生成的渲染選項. 如果使用者未提供或跳過renderOptions(返回 null)，null 合併運算子(??)將使用從 GetDefaultRenderOptions 獲得的默認 renderOptions()** function.

空合并运算符 C#（对开发人员的作用）：图 2 - 上述代码生成的 PDF