開發者更新

C#可空類型（對開發者如何理解的工作）

Q: 在 C# 中宣告可空型別的語法是什麼？

在 C# 中，您可以透過在資料型別後面附加問號 '?' 來宣告可空型別。例如，要宣告一個可空的整數，您可以寫 int? nullableInt = null; 。

Q: 空合併運算子在管理可空型別中扮演什麼角色？

空合併運算子 ?? 用於管理可空型別，當可空型別為空時提供一個預設值。它簡化了程式碼，並有助於避免顯式的 if-else 檢查。

Q: 如何檢查 C# 中的可空型別是否有值？

您可以使用 HasValue 屬性或直接將變數與 null 進行比較來確定 C# 中可空型別是否有值。

Jacob Mellor

已更新:2026年4月23日

當使用C#編程時，您經常需要處理null值，尤其是引用型別。C#中的nullable型別提供了一種方法來表示值型別的未定義或不存在的值。本指南涵蓋了C# nullable型別的基本要點，其實際用途，以及在不同情況下它們的工作原理。在本文的後半部分，我們還將探討IronPDF。

Nullable Types in C#

預設情況下，C#中的值型別（例如 int, bool, DateTime）不能賦予 null 值。為了應對這一限制，C# 引入了nullable 值型別，允許將 null 賦予值型別。nullable 型別在需要表示有效值的缺失時特別有用。

宣告可空型別

要在 C# 中宣告可空型別，您可以使用以下語法：

// Declare a nullable integer
int? nullableInt = null;

// Declare a nullable integer
int? nullableInt = null;

' Declare a nullable integer
Dim nullableInt? As Integer = Nothing

$vbLabelText $csharpLabel

在此，int? 是 Nullable<int> 的簡寫。 nullableInt 變數可以容納 int 值或 null。

檢查空值

要檢查 nullable 型別變數是否具有值，您可以使用 HasValue 屬性，或直接比較變數與 null，如下所示：

if (nullableInt.HasValue)
{
    // If nullableInt has a value, print it
    Console.WriteLine("Value: " + nullableInt.Value);
}
else
{
    // If nullableInt does not have a value, print a message
    Console.WriteLine("No value assigned.");
}

if (nullableInt.HasValue)
{
    // If nullableInt has a value, print it
    Console.WriteLine("Value: " + nullableInt.Value);
}
else
{
    // If nullableInt does not have a value, print a message
    Console.WriteLine("No value assigned.");
}

If nullableInt.HasValue Then
	' If nullableInt has a value, print it
	Console.WriteLine("Value: " & nullableInt.Value)
Else
	' If nullableInt does not have a value, print a message
	Console.WriteLine("No value assigned.")
End If

$vbLabelText $csharpLabel

此外，您也可以使用 null 合併運算符（??）來在 nullable 型別為 null 時提供預設值：

// Assign 0 if nullableInt is null
int result = nullableInt ?? 0;
Console.WriteLine("Result: " + result);

// Assign 0 if nullableInt is null
int result = nullableInt ?? 0;
Console.WriteLine("Result: " + result);

' Assign 0 if nullableInt is null
Dim result As Integer = If(nullableInt, 0)
Console.WriteLine("Result: " & result)

$vbLabelText $csharpLabel

如果 nullableInt 為 null，result 將被分配預設值 0。

nullable 值型別與 nullable 引用型別

在 C# 中，值型別（例如 int, bool 和 double）與引用型別（例如 string, object）不同。 nullable 值型別允許值型別表示 null，而 nullable 引用型別允許引用型別預設為非 nullable，從而減少空引用異常的風險。

nullable 值型別

nullable 值型別允許值型別取 null 值。要宣告 nullable 值型別，請在資料型別後面加上問號 ? ：

// Declare a nullable double
double? nullableDouble = null;

// Declare a nullable double
double? nullableDouble = null;

' Declare a nullable double
Dim nullableDouble? As Double = Nothing

$vbLabelText $csharpLabel

在此範例中，nullableDouble 可以容納 double 值或 null。

nullable 引用型別

nullable 引用型別是在 C# 8.0 中引入的。您可以在專案級別啟用 nullable 引用型別，或者在程式碼文件開頭新增 #nullable enable 指令。啟用 nullable 引用型別後，必須明確將引用型別標記為 nullable，使用 ?，以幫助避免由於 null 引用導致的潛在運行時異常。

#nullable enable
// Declare a nullable string
string? nullableString = null;

#nullable enable
// Declare a nullable string
string? nullableString = null;

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

$vbLabelText $csharpLabel

在此，nullableString 被允許為 null。如果您在未加入 ? 的情況下宣告一個非 nullable 引用型別，編譯器將在檢測到潛在的 null 賦值時產生警告。

啟用 nullable 引用型別

要在專案中全域啟用 nullable 引用型別，請將以下行新增到您的 .csproj 文件中：

<Nullable>enable</Nullable>

<Nullable>enable</Nullable>

XML

啟用後，編譯器將預設情況下將引用型別視為非 nullable。此功能特別有助於在編譯時捕獲 null 引用問題，而不是在運行時捕獲。

實際範例

讓我們探索一些實際範例以鞏固您對 nullable 型別的理解。

範例 1：值型別的 nullable 型別

在此範例中，我們將使用 int 的 nullable 型別：

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

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

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

$vbLabelText $csharpLabel

在此，nullableInt 是 int 的 nullable 型別變數。如果 nullableInt 為 null，b 因為 null 合併運算符而獲得值10。否則，b 取 nullableInt 的值。

範例 2：nullable 引用型別

現在，讓我們看看 nullable 引用型別如何運作：

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

#nullable enable
class Program
{
    static void Main()
    {
        string? nullableString = null;
        string nonNullableString = "Hello";
        // Use null coalescing operator to provide a default value for length
        Console.WriteLine(nullableString?.Length ?? 0);
        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"
		' Use null coalescing operator to provide a default value for length
		Console.WriteLine(If(nullableString?.Length, 0))
		Console.WriteLine(nonNullableString.Length)
	End Sub
End Class

$vbLabelText $csharpLabel

在上述程式碼中，nullableString 可以為 null，且 null 合併運算符確保如果它為 null，則字串的長度將預設為 0。

範例 3：巢狀的 nullable 型別

C# 允許宣告巢狀的 nullable 型別。例如：

// Redundant, but syntactically valid
int? nestedNullableInt = null;

// Redundant, but syntactically valid
int? nestedNullableInt = null;

' Redundant, but syntactically valid
Dim nestedNullableInt? As Integer = Nothing

$vbLabelText $csharpLabel

雖然巢狀的 nullable 型別看似多餘，但它們在 C# 中是語法上有效的。然而，在實踐中，巢狀的 nullable 型別並沒有提供任何額外的功能，而且很少使用。

Null 合併運算符（??）

null 合併運算符（??）經常與 nullable 型別一起使用，以在 nullable 型別為 null 時提供預設值。此運算符通過避免顯式的 if-else 檢查來簡化程式碼。

int? nullableValue = null;
// Assign -1 if nullableValue is null
int defaultValue = nullableValue ?? -1;

int? nullableValue = null;
// Assign -1 if nullableValue is null
int defaultValue = nullableValue ?? -1;

Dim nullableValue? As Integer = Nothing
' Assign -1 if nullableValue is null
Dim defaultValue As Integer = If(nullableValue, -1)

$vbLabelText $csharpLabel

在此範例中，如果 nullableValue 為 null，defaultValue 將賦值為 -1。否則，defaultValue 將取 nullableValue 的值。

編譯時錯誤與 nullable 型別

啟用 nullable 引用型別後，C# 在編譯時會產生警告和錯誤，以檢測到可能的 null 賦值問題。這些編譯時錯誤有助於早期發現問題，使您的程式碼更堅固。

請考慮以下範例：

string? nullableString = null;
// This will produce a compiler warning because nullableString may be null
string nonNullableString = nullableString;

string? nullableString = null;
// This will produce a compiler warning because nullableString may be null
string nonNullableString = nullableString;

'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
'ORIGINAL LINE: string? nullableString = null;
Dim nullableString As String = Nothing
' This will produce a compiler warning because nullableString may be null
Dim nonNullableString As String = nullableString

$vbLabelText $csharpLabel

在此情形下，將 nullableString 賦給 nonNullableString 會導致編譯器警告，因為 nullableString 可能為 null，將其賦給非 nullable 型別可能導致運行時異常。

在IronPDF中使用可空型別

C# Nullable 型別（開發人員的工作原理）：圖1 - IronPDF：C# PDF 程式庫

IronPDF 是一個 C# PDF 程式庫，旨在幫助開發人員從 .NET 應用程式直接建立、編輯和操作 PDF 文件。您可以將HTML轉換為PDF，生成報告，甚至處理複雜的文件結構。

在動態報告生成場景中，使用 nullable 型別尤其有用，例如當您為會計師生成包含不完整財務資料的 PDF 時。通過使用可空型別，您可以管理可選字段，避免異常，並提供預設值。

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

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        int? optionalIncome = null;  // Nullable type for optional income
        string? clientName = "Iron Dev";  // Nullable reference type for client name
        var renderer = new ChromePdfRenderer();
        string htmlContent = $@"
            <h1>Financial Report</h1>
            <p>Client Name: {clientName ?? "Unknown"}</p>
            <p>Income: {optionalIncome?.ToString() ?? "Data not available"}</p>";
        // Render the HTML to a PDF
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        // Save the PDF to disk
        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 for optional income
'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 for client name
		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>"
		' Render the HTML to a PDF
		Dim pdf = renderer.RenderHtmlAsPdf(htmlContent)
		' Save the PDF to disk
		pdf.SaveAs("FinancialReport.pdf")
		Console.WriteLine("PDF Generated Successfully.")
	End Sub
End Class

$vbLabelText $csharpLabel

C# Nullable 型別（開發人員的工作原理）：圖2 - 範例程式碼輸出

在此程式碼中，使用了 nullable 型別 (int? 和 string?) 來安全處理缺失的資料。 null 合併運算符（??）確保如果任何資料丟失，則PDF中使用的是預設值。

結論

C# null 型別（開發人員的工作方式）：圖3 - IronPDF 許可頁

C# 中的可空型別是處理值型別和引用型別中的 null 值的強大工具。通過使用可空型別，您可以避免空引用異常並提高程式碼的穩健性。請記得在新專案中啟用 nullable 引用型別，以受益於編譯時錯誤檢查，並在處理 nullable 型別時使用 null 合併運算符（??）來簡化您的程式碼。

IronPDF 提供免費試用，幫助您在做出承諾前探索其功能。沒有前期成本，您可以嘗試看看它如何融入您的開發過程。一旦您準備好前進，許可證從 $999 開始。

常見問題

可空型別如何在動態 PDF 生成中被利用？

可空型別在動態 PDF 生成中是很重要的，因為它們允許使用像 IronPDF 程式庫這樣的工具安全地表示可選字段。這確保了缺失的資料能被適當處理，必要時提供預設值。

在 C# 中宣告可空型別的語法是什麼？

在 C# 中，您可以透過在資料型別後面附加問號 '?' 來宣告可空型別。例如，要宣告一個可空的整數，您可以寫 int? nullableInt = null;。

C# 中的可空型別會影響生成報告的穩健性嗎？

是的，使用可空型別可以增強生成報告的穩健性，因為它可確保當可選字段的值不存在時不會發生錯誤。像 IronPDF 的程式庫可以有效地利用可空型別來管理這些情況。

可空引用型別如何幫助防止運行時錯誤？

可空引用型別在 C# 8.0 中引入，允許引用型別預設為非可空，這減少了空引用異常的風險，並允許在編譯期間及早檢測潛在問題。

空合併運算子在管理可空型別中扮演什麼角色？

空合併運算子 ?? 用於管理可空型別，當可空型別為空時提供一個預設值。它簡化了程式碼，並有助於避免顯式的 if-else 檢查。

如何檢查 C# 中的可空型別是否有值？

您可以使用 HasValue 屬性或直接將變數與 null 進行比較來確定 C# 中可空型別是否有值。

在 C# 應用程式中使用可空型別的典型情境有哪些？

可空型別經常用於資料可能不完整或可選的情況，例如表單輸入、配置設置或與允許空值的資料庫進行介面操作。它們在使用像 IronPDF 程式庫進行動態報告生成中特別有用。

啟用可空引用型別會如何影響 C# 專案的編譯？

在 C# 專案中啟用可空引用型別會對潛在的空引用問題發出編譯時警告和錯誤，從而及早察覺問題並促進更可靠的程式碼開發。

Jacob Mellor

立即與工程團隊聊天

首席技術官

Jacob Mellor是Iron Software的首席技術官，一位在C# PDF技術上開創先河的遠見工程師。作為Iron Software核心程式碼庫的原開發者，他從創立以來就一直在塑造公司的產品架構，與首席執行官Cameron Rimington一起將公司轉變為服務於NASA、特斯拉和全球政府公司的50多名人員的公司。

Jacob擁有曼徹斯特大學的土木工程一等榮譽學士學位（BEng），於1998-2001年之間獲得。在1999年於倫敦創辦他的第一家軟體公司並於2005年建立了他的第一批.NET元組件後，他專注於解決Microsoft生態系統中的複雜問題。

他的旗艦IronPDF和Iron Suite .NET程式庫在全球獲得了超過3000萬次NuGet安裝依據，他的基礎程式碼基繼續支援著世界各地開發者使用的工具。擁有25年的商業經驗和41年的程式設計專業知識，他仍專注於推動企業級C#、Java和Python PDF技術的創新，同時指導下一代技術領導者。

已更新2026年4月23日

在 .NET 中用 Microsoft.Extensions.AI 簡化 LLM 整合

AI 正在改變軟體開發，但將大型語言模型 (LLM) 整合到 .NET 中一直很複雜。利用 IronPdf.AI 將 AI 整合推向更遠，為 .NET 應用程式帶來由 OpenAI 驅動的 PDF 解析、資料擷取和內容總結。

已更新2026年4月21日

通過 IronPDF 最新更新簡化電子開票：PDF/A-3 合規性和 ZUGFeRD 支援

了解 IronPDF 的更新如何實現 PDF/A-3 合規性和 ZUGFeRD 支援，簡化電子發票流程，幫助企業遵守歐盟發票要求。

已更新2026年4月23日

IronPDF 開發者更新，2022 年 10 月

來自 IronPDF 工程團隊的 10 月更新。

C# ConfigureAwait（對開發者如何理解的工作）

C#命名規則（對開發者如何...

客戶亮點：

開發者聚焦：

網路研討會：

開始免費30天試用

C#可空類型（對開發者如何理解的工作）

Nullable Types in C#

宣告可空型別

檢查空值

nullable 值型別與 nullable 引用型別

nullable 值型別

nullable 引用型別

啟用 nullable 引用型別

實際範例

範例 1：值型別的 nullable 型別

範例 2：nullable 引用型別

範例 3：巢狀的 nullable 型別

Null 合併運算符（??）

編譯時錯誤與 nullable 型別

在IronPDF中使用可空型別

結論

常見問題

可空型別如何在動態 PDF 生成中被利用？

在 C# 中宣告可空型別的語法是什麼？

C# 中的可空型別會影響生成報告的穩健性嗎？

可空引用型別如何幫助防止運行時錯誤？

空合併運算子在管理可空型別中扮演什麼角色？

如何檢查 C# 中的可空型別是否有值？

在 C# 應用程式中使用可空型別的典型情境有哪些？

啟用可空引用型別會如何影響 C# 專案的編譯？

您的授權金鑰已經發送到您的收件箱

您的演示請求已提交。

Iron 支援團隊

開始免費30天試用

C#可空類型（對開發者如何理解的工作）

Nullable Types in C#

宣告可空型別

檢查空值

nullable 值型別與 nullable 引用型別

nullable 值型別

nullable 引用型別

啟用 nullable 引用型別

實際範例

範例 1：值型別的 nullable 型別

範例 2：nullable 引用型別

範例 3：巢狀的 nullable 型別

Null 合併運算符（??）

編譯時錯誤與 nullable 型別

在IronPDF中使用可空型別

結論

常見問題

可空型別如何在動態 PDF 生成中被利用？

在 C# 中宣告可空型別的語法是什麼？

C# 中的可空型別會影響生成報告的穩健性嗎？

可空引用型別如何幫助防止運行時錯誤？

空合併運算子在管理可空型別中扮演什麼角色？

如何檢查 C# 中的可空型別是否有值？

在 C# 應用程式中使用可空型別的典型情境有哪些？

啟用可空引用型別會如何影響 C# 專案的編譯？

相關文章

在 .NET 中用 Microsoft.Extensions.AI 簡化 LLM 整合

通過 IronPDF 最新更新簡化電子開票：PDF/A-3 合規性和 ZUGFeRD 支援

IronPDF 開發者更新，2022 年 10 月

下一步：開始免費30天試用

Thank You

下一步：開始免費30天試用

想免費將 IronSuite 部署到實際專案中嗎？

包含什麼？

您的授權金鑰已經發送到您的收件箱

您的演示請求已提交。

受到全球數百萬工程師的信任

Iron 支援團隊