.NET 帮助

C# 可空类型（如何为开发人员工作）

坎那帕·乌东攀

2024年十月24日

在使用 C# 时，您经常需要处理空值C# 中的 Nullable 类型提供了一个新的功能，尤其是在引用类型方面。C# 中的可空类型为值类型提供了一种表示未定义或不存在值的方法。本指南涵盖 C# 可空类型的要点、实际用途以及它们在不同场景下的工作方式。我们将探索IronPDF以及文章后面的内容。

C# 和 num 中的可空类型；

默认情况下，C# 中的值类型(例如，int、bool、DateTime)不能赋空值。为了解决这一限制，C# 引入了可空值类型，允许您为值类型赋值为空。当您需要表示不存在有效值时，可空类型尤其有用。

声明可空类型

要在 C# 中声明可归零类型，您可以使用以下语法：

// Nullable type variable value
int? nullableInt = null;

// Nullable type variable value
int? nullableInt = null;

' Nullable type variable value
Dim nullableInt? As Integer = Nothing

$vbLabelText $csharpLabel

在这里，int? 是 Nullable 的缩写. nullableInt 变量既可以保存 int 值，也可以保存 null。

检查是否为空

要检查可空类型变量是否有值，可以使用 HasValue 属性或直接将变量与 null 进行比较。例如

if (nullableInt.HasValue)
{
    Console.WriteLine("Value: " + nullableInt.Value);
}
else
{
    Console.WriteLine("No value assigned.");
}

if (nullableInt.HasValue)
{
    Console.WriteLine("Value: " + nullableInt.Value);
}
else
{
    Console.WriteLine("No value assigned.");
}

If nullableInt.HasValue Then
	Console.WriteLine("Value: " & nullableInt.Value)
Else
	Console.WriteLine("No value assigned.")
End If

$vbLabelText $csharpLabel

或者，您也可以使用空凝聚运算符(??)当 nullable 类型为空时提供默认值：

int result = nullableInt ?? 0;
Console.WriteLine("Result: " + result);

int result = nullableInt ?? 0;
Console.WriteLine("Result: " + result);

Dim result As Integer = If(nullableInt, 0)
Console.WriteLine("Result: " & result)

$vbLabelText $csharpLabel

如果 nullableInt 为空，结果将被分配为默认值 0。

可空值类型与可空引用类型

在 C# 中，值类型(如 int、bool 和 double)与参考类型不同(如字符串、对象). 可空值类型允许值类型表示空，而可空引用类型允许引用类型默认为不可空，从而降低了出现空引用异常的风险。

可空值类型

可空值类型允许值类型接受空值。要声明可空值类型，请在? 到数据类型：

double? nullableDouble = null;

double? nullableDouble = null;

Dim nullableDouble? As Double = Nothing

$vbLabelText $csharpLabel

在这个示例中，nullableDouble 可以保存 double 值或 null。

可空引用类型

C# 8.0 引入了可空引用类型。您可以在项目级别或通过在代码文件开头添加 #nullable 启用指令来启用可空引用类型。启用可空引用类型后，引用类型必须使用"...... "显式标记为可空，这有助于避免空引用导致的潜在运行时异常。

#nullable enable
string? nullableString = null;

#nullable enable
string? nullableString = null;

'INSTANT VB TODO TASK: There is no equivalent to #nullable in VB:
'#nullable enable
'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
'ORIGINAL LINE: string? nullableString = null;
Dim nullableString As String = Nothing

$vbLabelText $csharpLabel

此处允许 nullableString 为空。如果在声明非空引用类型时不带?，编译器在检测到潜在的空赋值时会产生警告。

启用可归零引用类型

要在项目中全局启用可归零引用类型，请在 .csproj 文件中添加以下一行：

<Nullable>enable</Nullable>

<Nullable>enable</Nullable>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<Nullable> enable</Nullable>

$vbLabelText $csharpLabel

一旦启用，编译器将默认把引用类型视为不可归零类型。该功能尤其便于在编译时而不是运行时捕捉空引用问题。

实例

让我们通过一些实际例子来巩固您对可空类型的理解。

例 1：带值类型的可空类型

在本例中，我们将使用 int 作为可空类型：

class Program
{
    static void Main(string[] args)
    {
        int? nullableInt = null;
        int b = nullableInt ?? 10; // Use null coalescing operator
        Console.WriteLine("b: " + b);
        if (nullableInt.HasValue)
        {
            Console.WriteLine("nullableInt has value: " + nullableInt.Value);
        }
        else
        {
            Console.WriteLine("nullableInt is null");
        }
    }
}

class Program
{
    static void Main(string[] args)
    {
        int? nullableInt = null;
        int b = nullableInt ?? 10; // Use null coalescing operator
        Console.WriteLine("b: " + b);
        if (nullableInt.HasValue)
        {
            Console.WriteLine("nullableInt has value: " + nullableInt.Value);
        }
        else
        {
            Console.WriteLine("nullableInt is null");
        }
    }
}

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim nullableInt? As Integer = Nothing
		Dim b As Integer = If(nullableInt, 10) ' Use null coalescing operator
		Console.WriteLine("b: " & b)
		If nullableInt.HasValue Then
			Console.WriteLine("nullableInt has value: " & nullableInt.Value)
		Else
			Console.WriteLine("nullableInt is null")
		End If
	End Sub
End Class

$vbLabelText $csharpLabel

这里，nullableInt 是一个 int 的可空类型变量。如果 nullableInt 为空，由于空凝聚运算符的作用，b 将得到值 10。否则，b 的值为 nullableInt。

示例 2：可归零引用类型

现在，让我们来看看可空引用类型是如何工作的：

#nullable enable
class Program
{
    static void Main()
    {
        string? nullableString = null;
        string nonNullableString = "Hello";
        Console.WriteLine(nullableString?.Length ?? 0); // Use null coalescing operator
        Console.WriteLine(nonNullableString.Length);
    }
}

#nullable enable
class Program
{
    static void Main()
    {
        string? nullableString = null;
        string nonNullableString = "Hello";
        Console.WriteLine(nullableString?.Length ?? 0); // Use null coalescing operator
        Console.WriteLine(nonNullableString.Length);
    }
}

'INSTANT VB TODO TASK: There is no equivalent to #nullable in VB:
'#nullable enable
Friend Class Program
	Shared Sub Main()
'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
'ORIGINAL LINE: string? nullableString = null;
		Dim nullableString As String = Nothing
		Dim nonNullableString As String = "Hello"
		Console.WriteLine(If(nullableString?.Length, 0)) ' Use null coalescing operator
		Console.WriteLine(nonNullableString.Length)
	End Sub
End Class

$vbLabelText $csharpLabel

在上面的代码中，nullableString 可以为空，而空值凝聚运算符可确保如果为空，字符串的长度默认为 0。

示例 3：嵌套的可归零类型

C# 允许您声明嵌套的可空类型。例如

int?? nestedNullableInt = null;

int?? nestedNullableInt = null;

If(Integer, nestedNullableInt) = Nothing

$vbLabelText $csharpLabel

虽然嵌套的可空类型看似多余，但在 C# 中它们在语法上是有效的。然而，在实践中，嵌套的可空类型并不提供任何额外功能，也很少使用。

空凝聚操作符 (??)

空凝聚运算符(??)经常与可空类型一起使用，在可空类型为空时提供默认值。该操作符通过避免明确的 if-else 检查来简化代码。

int? nullableValue = null;
int defaultValue = nullableValue ?? -1;

int? nullableValue = null;
int defaultValue = nullableValue ?? -1;

Dim nullableValue? As Integer = Nothing
Dim defaultValue As Integer = If(nullableValue, -1)

$vbLabelText $csharpLabel

在本例中，如果 nullableValue 为空，defaultValue 将被赋值为-1。否则，defaultValue 将取 nullableValue 的值。

编译时错误和可空类型

启用可空引用类型后，C# 在检测到空赋值的潜在问题时，会在编译过程中产生警告和错误。这些编译时错误有助于及早发现问题，使您的代码更加健壮。

考虑以下示例：

string? nullableString = null;
string nonNullableString = nullableString; // Compiler warning

string? nullableString = null;
string nonNullableString = nullableString; // Compiler warning

'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
'ORIGINAL LINE: string? nullableString = null;
Dim nullableString As String = Nothing
Dim nonNullableString As String = nullableString ' Compiler warning

$vbLabelText $csharpLabel

在本例中，将 nullableString 赋值给 nonNullableString 会产生编译器警告，因为 nullableString 可能为空，将其赋值给非空类型可能会导致运行时异常。

使用 IronPDF 中的可空类型

C# Nullable Types（如何为开发人员工作）：图 1 - IronPDF：C# PDF 库

IronPDF是一个 C# PDF 库，旨在帮助开发人员直接从 .NET 应用程序中创建、编辑和处理 PDF 文件。你可以将 HTML 转换为 PDF此外，翻译工作还必须考虑到.NET、Java、Python 或 Node js 等软件开发工具的功能和优势，同时保持技术准确性。

可空类型在动态报告生成场景中特别有用，例如当您为会计师生成财务数据不完整的 PDF 时。通过使用可归零类型，您可以管理可选字段、避免异常并提供默认值

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        int? optionalIncome = null;  // Nullable type
        string? clientName = "Iron Dev";  // Nullable reference type
        var renderer = new ChromePdfRenderer();
        string htmlContent = $@"
            <h1>Financial Report</h1>
            <p>Client Name: {clientName ?? "Unknown"}</p>
            <p>Income: {optionalIncome?.ToString() ?? "Data not available"}</p>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("FinancialReport.pdf");
        Console.WriteLine("PDF Generated Successfully.");
    }
}

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        int? optionalIncome = null;  // Nullable type
        string? clientName = "Iron Dev";  // Nullable reference type
        var renderer = new ChromePdfRenderer();
        string htmlContent = $@"
            <h1>Financial Report</h1>
            <p>Client Name: {clientName ?? "Unknown"}</p>
            <p>Income: {optionalIncome?.ToString() ?? "Data not available"}</p>";
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        pdf.SaveAs("FinancialReport.pdf");
        Console.WriteLine("PDF Generated Successfully.");
    }
}

Imports IronPdf
Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim optionalIncome? As Integer = Nothing ' Nullable type
'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
'ORIGINAL LINE: string? clientName = "Iron Dev";
		Dim clientName As String = "Iron Dev" ' Nullable reference type
		Dim renderer = New ChromePdfRenderer()
		Dim htmlContent As String = $"
            <h1>Financial Report</h1>
            <p>Client Name: {If(clientName, "Unknown")}</p>ignoreignore<p>Income: {If(optionalIncome?.ToString(), "Data not available")}</p>"
		Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
		pdf.SaveAs("FinancialReport.pdf")
		Console.WriteLine("PDF Generated Successfully.")
	End Sub
End Class

$vbLabelText $csharpLabel

C# Nullable Types（如何为开发人员工作）：图 2 - 示例代码输出

在本代码中，可空类型(译员和字符串？)用于安全处理缺失数据。空凝聚运算符(??)确保如果缺少任何数据，PDF 中将使用默认值。

结论

C# Nullable Types（如何为开发人员工作）：图 3 - IronPDF 许可页面

C# 中的可空类型是在值类型和引用类型中处理空值的强大工具。通过使用可空类型，您可以避免空引用异常并提高代码的健壮性。切记在新项目中启用可空引用类型，以受益于编译时错误检查，并使用空凝聚运算符(??)在处理可空类型时简化代码。

IronPDF 提供一个免费试用在您做出承诺之前，我们可以帮助您了解这些工具的功能。前期无需任何费用，您可以试水，看看如何将其融入您的开发流程。一旦您准备好继续，许可证起价为 $749。

坎那帕·乌东攀

立即与工程团队聊天

软件工程师

在成为软件工程师之前，Kannapat 从日本北海道大学完成了环境资源博士学位。在攻读学位期间，Kannapat 还成为了生物生产工程系车辆机器人实验室的成员。2022年，他利用自己的 C# 技能加入了 Iron Software 的工程团队，专注于 IronPDF。Kannapat 珍视他的工作，因为他能直接向编写 IronPDF 大部分代码的开发者学习。除了同伴学习，Kannapat 还享受在 Iron Software 工作的社交方面。不写代码或文档时，Kannapat 通常在 PS5 上玩游戏或重看《最后生还者》。

< 前一页
C# ConfigureAwait（面向开发人员的工作原理）

下一步 >
C# 命名约定（如何为开发人员工作）