1. IronPDF
  2. IronPDF博客
  3. .NET 帮助
  4. C# 空合并运算符
.NET 帮助

C# 空合并运算符（开发者指南）

发布 2024年一月14日
分享:

在 C# 编程不断发展的过程中，开发人员经常会遇到处理空值类型的难题。为了解决这个问题，C# 提供了一个优雅的解决方案，即 Null Coalescing Operator (??).

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

了解空凝聚操作符

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

基础知识：语法和用法

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

string name = possiblyNullName ?? "DefaultName";
string name = possiblyNullName ?? "DefaultName";
Dim name As String = If(possiblyNullName, "DefaultName")
VB   C#

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

简化空值检查

Null Coalescing 操作符的主要优点之一是能够简化 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 操作符可以链式连接，以提供一系列后备值，从而实现默认值的级联方法。

string result = possiblyNullString ?? fallbackString ?? "DefaultValue";
string result = possiblyNullString ?? fallbackString ?? "DefaultValue";
Dim result As String = If(If(possiblyNullString, fallbackString), "DefaultValue")
VB   C#

在本例中，如果 possiblyNullString 为空，运算符会检查 fallbackString。如果两者都为空，则最终的回退字符串为 "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#

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

与三元运算符整合

空凝聚运算符可与三元运算符相结合 (?:) 进行更高级的条件处理。

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：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 文档，随后保存到指定位置。

空值聚合运算符与 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（获取用户提供的渲染选项() 函数是一个逻辑占位符，用于检索用户提供的 ChromePdfRenderOptions.如果用户没有提供或跳过 renderOptions (返回空)，空凝聚算子 (??) 将使用从GetDefaultRenderOptions获取的默认渲染选项。()** 功能。

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

有关更多选项和 PDF 相关任务，请访问此处 文件 IronPDF 网站上的页面。

结论

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

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

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

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

< 前一页
Math.NET C#（如何为开发者工作）
下一步 >
C# 主构造函数（对开发人员的工作原理）

报告问题

准备开始了吗？ 版本： 2024.9 刚刚发布

免费NuGet下载 总下载量: 10,731,156 查看许可证 >

获取您的免费

30天试用密钥 立即。

15天试用密钥 立即。

bullet_checked无需信用卡或创建账户
试用表格已提交
成功地。

您的试用密钥应在电子邮件中。
如果不是，请联系
support@ironsoftware.com

子弹测试测试生产环境
无水印
子弹日历30天全功能使用
功能性产品
子弹支持24/5技术支持
试用期间的支持

谢谢！

您的许可证密钥已发送到所提供的电子邮件。联系我们

24小时升级优惠：

Save 50% 在一个
专业 升级

去 专业 支持10位开发者
和无限项目。

小时

:

分钟

:

秒

升级到Professional

升级

专业

$600 美元

$299 美元

  • 10位开发者
  • 10个位置
  • 10个项目
今天 只有

5个.NET产品，两件的价格

IronPDF IronOCR IronXL IronBarcode IronWebscraper

套件总价值：

$7,192 美元

升级价格

今天
只有

$499 美元

24小时后

$1,098 美元