.NET 帮助

空合并运算符 C#（开发者如何使用）

发布 2024年一月14日

在 C# 编程不断发展的过程中，开发人员会遇到一些场景，其中处理可空值类型是一个常见的挑战。为了解决这个问题，C# 提供了一个优雅的解决方案--.NET、Java、Python 或 Node js。Null Coalescing Operator (??).

在本文中，我们将探讨使用 Null Coalescing Operator 的细微差别，了解其功能、用例以及它如何改变您在 C# 代码中处理可空类型值的方式。

理解空凝聚操作符

空凝聚操作符(??)或 Null 条件运算符是 C# 中简洁而强大的二进制运算符，旨在简化空值处理。它提供了一种简洁的语法，用于在遇到可空类型或引用类型时选择默认值，从而减少对冗长的空检查的需求。

基础知识：语法和用法

Null Coalescing Operator 的语法简单明了。它由两个连续的问号组成(??). 该操作符用于在左侧表达式求值为空时提供默认值。

string name = possiblyNullName ?? "DefaultName";

string name = possiblyNullName ?? "DefaultName";

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

VB C#

在本例中，如果 possiblyNullName 为空，变量 name 将被赋值为 "DefaultName"。

简化空检查

Null Coalescing Operator 的主要优点之一是能够简化 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#

模板代码的减少提高了代码的清晰度，降低了出现与空有关的错误的几率。

针对默认值的链式空凝聚操作符

Null Coalescing Operator（空聚合运算符）可以通过链式连接提供一系列后备值，从而实现级联默认值。

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

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

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

VB C#

在本例中，如果 possiblyNullString 为空，运算符将检查 fallbackString。如果两者都为空，则最终的后备选项为 "DefaultValue"。

方法参数中的应用

Null Coalescing Operator 在指定方法参数的默认值时特别有用。

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#

在此方法中，如果信息为空，则使用默认值 "默认信息"。

与三元运算符集成

空凝聚操作符可与三元操作符结合使用(? :)进行更高级的条件处理。

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 强国

C# 的 Null Coalescing Operator（如何为开发人员工作）：图 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 文档，并随后保存到指定位置。

Null Coalescing Operator 与 IronPDF 的集成

虽然 Null Coalescing Operator 主要是在变量赋值和方法参数等各种情况下处理空值的语言功能，但它与 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(返回空)，空凝聚算子(??)将使用从GetDefaultRenderOptions获取的默认渲染选项。()函数。

C# 的 Null Coalescing Operator（开发人员如何使用）：图 2 - 上述代码生成的 PDF

有关更多选项和 PDF 相关任务，请访问此处IronPDF 文档在 IronPDF 网站上。

结论

总之，C# 中的空凝聚操作符为处理空值提供了一种简洁而富有表现力的方法。它的简洁性和可读性使其成为提高代码质量和减少冗余的重要工具。无论是处理方法参数、变量赋值还是复杂的条件逻辑，Null Coalescing Operator 都能让开发人员在 C# 编程的动态世界中优雅地驾驭空值。

IronPdf 和 C# Null Coalescing Operator 在开发领域相辅相成。 IronPDF 擅长 PDF 文档生成，而 Null Coalescing Operator 则提供了一种简洁优雅的方法来处理 C# 代码中的空值。

虽然它们的直接集成可能不是重点，但与 IronPDF 相关变量和配置配合使用空凝聚操作符，甚至在提供 HTML 字符串时使用空凝聚操作符，可以增强文档生成代码的整体健壮性和可读性。利用 IronPDF 的强大功能和 Null Coalescing Operator 的优雅特性，提升您的 C# 文档生成工作流程。

IronPDF 提供一个免费试用其 PDF 库让用户在做出决定前测试其全部功能。

< 前一页
Math.NET C#（它如何为开发人员工作）

下一步 >
C# 主构造函数（开发人员如何使用）