跳至頁尾內容
.NET 幫助

C# 可空型別(開發者如何理解)

使用 C# 工作時,您經常需要處理 空值,尤其是引用類型。C# 中的 Nullable 類型提供一種方式來表示值類型的未定義或不存在值。本指南涵蓋 C# nullable 類型的要點、實際用途,以及它們在不同情況下的運作方式。 我們稍後也會探討 IronPDF

C# 中的可歸零類型;

根據預設,C# 中的值類型 (例如 int、bool、DateTime) 不能指定為空值。 為了解決這個限制,C# 引進了 nullable 值類型,讓您可以將 null 指定給值類型。當您需要表示沒有有效值時,Nullable 類型特別有用。

宣告可為空的類型

要在 C# 中宣告一個 nullable 類型,您可以使用下列語法:

// Declare a nullable integer
int? nullableInt = null;
// Declare a nullable integer
int? nullableInt = null;
$vbLabelText   $csharpLabel

在此,int?Nullable<int> 的縮寫。 nullableInt 變數可以持有 int 值或 null。

檢查 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.");
}
$vbLabelText   $csharpLabel

另外,當 nullable 類型為 null 時,您也可以使用 null coalescing 運算符 (??) 來提供預設值:

// 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);
$vbLabelText   $csharpLabel

如果 nullableInt 為空,result 將被指定預設值 0。

可空值類型 vs 可空參考類型

在 C# 中,值類型(如 int、bool 和 double)與參考類型(如字串、物件)不同。 Nullable 值類型允許值類型表示 null,而 nullable 參考類型則允許參考類型預設為不可為空,從而降低出現 null 參考異常的風險。

可空值類型

nullable 值類型允許值類型接受 null 值。 若要宣告 nullable 值類型,請將問號 ? 附加到資料類型:

// Declare a nullable double
double? nullableDouble = null;
// Declare a nullable double
double? nullableDouble = null;
$vbLabelText   $csharpLabel

在這個範例中,nullableDouble 可以持有 double 值或 null。

可為空的參考類型

C# 8.0 引入了可空引用類型。您可以在專案層級啟用可空參考類型,或在程式碼檔案的開頭加入 #nullable enable 指令。啟用 nullable 參考類型後,必須使用 ? 將參考類型明確地標示為 nullable,這有助於避免 null 參考所導致的潛在執行時異常。

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

這裡,nullableString 允許為 null。 如果您在宣告不可為空的參照類型時沒有使用 ? 的話,編譯器在偵測到潛在的 null 指定時會產生警告。

啟用 Nullable 參考類型

若要在專案中全域啟用 nullable 參考類型,請在 .csproj 檔案中加入以下一行:

<Nullable>enable</Nullable>
<Nullable>enable</Nullable>
XML

啟用後,編譯器預設會將參考類型視為不可歸空。 此功能特別方便在編譯時而非執行時捕捉 null reference 問題。

實用範例

讓我們探討一些實例來鞏固您對 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");
        }
    }
}
$vbLabelText   $csharpLabel

這裡,nullableInt 是一個 int 的 nullable 類型變數。 如果 nullableInt 為空,b 會因為 null coalescing 運算子而得到值 10。 否則,b 的值為 nullableInt

範例 2:可歸空的參照類型

現在,讓我們來看看 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);
    }
}
$vbLabelText   $csharpLabel

在上面的程式碼中,nullableString 可以為空,而 null coalescing 運算子可確保如果為空,字串的長度預設為 0。

範例 3:嵌套的 Nullable 類型

C# 允許您宣告嵌套的 nullable 類型。例如

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

儘管嵌套的 nullable 類型看似多餘,但在 C# 中它們在語法上是有效的。 然而,實際上,嵌套的 nullable 類型並沒有提供任何額外的功能,也很少被使用。

空凝聚運算符號 (??)

null coalescing 運算符 (??) 經常與 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;
$vbLabelText   $csharpLabel

在這個範例中,如果 nullableValue 為空,defaultValue 將被指定為 -1。否則,defaultValue 將採用 nullableValue 的值。

編譯時錯誤和可歸零類型

啟用 nullable reference types 後,C# 在偵測到 null assignments 的潛在問題時,會在編譯過程中產生警告和錯誤。 這些編譯時錯誤有助於及早發現問題,使您的程式碼更穩健。

請考慮以下範例:

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;
$vbLabelText   $csharpLabel

在這種情況下,將 nullableString 指派給 nonNullableString 會產生編譯器警告,因為 nullableString 可能是 null,而將其指派給非 nullable 類型可能會導致執行時異常。

使用 IronPDF 的可空類型

C# Nullable Types (How It Works For Developers):圖 1 - IronPdf:C# PDF Library

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

Nullable 類型在動態報表產生的情境中特別有用,例如當您為財務資料不完整的會計師產生 PDF 時。 透過使用 nullable 類型,您可以管理可選欄位、避免異常並提供預設值。

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.");
    }
}
$vbLabelText   $csharpLabel

C# Nullable Types (How It Works For Developers):圖 2 - 範例程式碼輸出

在此程式碼中,使用 nullable 類型 (int?string?) 來安全地處理遺失的資料。 null coalescing 運算符 (??) 可確保如果有任何資料遺失,PDF 中會使用預設值。

結論

C# Nullable Types (How It Works For Developers):圖 3 - IronPDF 授權頁面

C# 中的可空類型是處理值類型和參照類型中的空值的強大工具。透過使用 nullable 類型,您可以避免 null reference 異常,並改善程式碼的穩健性。 請記住在新專案中啟用 nullable 參考類型,以受益於編譯時錯誤檢查,並在處理 nullable 類型時使用 null coalescing 運算符 (??) 來簡化您的程式碼。

IronPdf 提供 免費試用,幫助您在做出承諾之前探索其功能。 由於前期不需要任何費用,您可以先試水,看看它如何融入您的開發流程。 一旦您準備好向前邁進,授權就會從 $799 開始。

常見問題解答

如何在動態 PDF 生成中使用可空型別?

可空類型在動態 PDF 生成中至關重要,它允許使用 IronPDF 等庫安全地表示可選欄位。這確保了缺失資料得到妥善處理,並在必要時提供預設值。

C#中宣告可空類型的語法是什麼?

在 C# 中,可以透過在資料型別後面附加問號「?」來宣告可空型別。例如,要宣告一個可空整數,可以這樣寫: int? nullableInt = null;

C# 中的可空類型會影響產生報表的健全性嗎?

是的,使用可空類型可以增強產生報表的健全性,確保選用欄位在缺少值時不會引發錯誤。像 IronPDF 這樣的庫可以利用可空類型來有效地管理這些情況。

可空引用類型如何協助防止執行時間錯誤?

C# 8.0 中引入的可空引用類型,透過允許引用類型預設不可為空,有助於防止執行時間錯誤。這降低了空引用異常的風險,並允許在編譯期間及早發現潛在問題。

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

空值合併運算子??用於管理可空類型,當可空類型為空時,它會提供一個預設值。這簡化了程式碼,並有助於避免明確的 if-else 判斷。

在 C# 中如何檢查可空型別是否有值?

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

在 C# 應用程式中使用可空類型的典型場景有哪些?

可空類型常用於資料可能不完整或可選的場景,例如表單輸入、配置設置,或與允許空值的資料庫互動時。它們在使用 IronPDF 等庫產生動態報表時尤其有用。

啟用可空引用類型會對 C# 專案編譯產生什麼影響?

在 C# 專案中啟用可空引用類型會導致編譯時出現針對潛在空引用問題的警告和錯誤,從而及早發現問題並促進更健壯的程式碼開發。

Jacob Mellor,Team Iron 首席技術官
首席技術長

Jacob Mellor 是 Iron Software 的首席技術官,也是一位富有遠見的工程師,率先開發了 C# PDF 技術。作為 Iron Software 核心程式碼庫的最初開發者,他自公司成立之初便參與塑造了其產品架構,並與執行長 Cameron Rimington 一起將其發展成為一家擁有 50 多名員工、服務於 NASA、特斯拉和全球政府機構的公司。

Jacob 於 1998 年至 2001 年在曼徹斯特大學獲得土木工程一級榮譽學士學位。 1999 年,他在倫敦創辦了自己的第一家軟體公司;2005 年,他創建了自己的第一個 .NET 元件。此後,他專注於解決微軟生態系統中的複雜問題。

他的旗艦產品 IronPDF 和 IronSuite .NET 庫在全球 NuGet 上的安裝量已超過 3000 萬次,其基礎程式碼持續為全球開發者工具提供支援。憑藉 25 年的商業經驗和 41 年的程式設計專長,Jacob 始終致力於推動企業級 C#、Java 和 Python PDF 技術的創新,同時指導下一代技術領導者。