C#變量後驚嘆號（範例）

邏輯非運算子

bool isLoggedIn = false;
if (!isLoggedIn)
{
    Console.WriteLine("User is not logged in.");
}

bool isLoggedIn = false;
if (!isLoggedIn)
{
    Console.WriteLine("User is not logged in.");
}

Dim isLoggedIn As Boolean = False
If Not isLoggedIn Then
	Console.WriteLine("User is not logged in.")
End If

null 條件運算子（?.）與 null-forgiving 運算子（!）

C# 提供了若干工具來管理 null 值狀態，了解其差異對於有效編碼非常重要。 在這種情況下，兩個最重要的運算子是 null 條件運算子（?.）和 null-forgiving 運算子（!）。

• null 條件運算子（?.）：這個運算子允許安全地訪問可能為 null 的對象的屬性或方法。 通過使用 ?.，可以防止 null 狀態異常，而不必明確檢查對象是否為 null。

  string? userName = null;
  int userNameLength = userName?.Length ?? 0; // Returns 0 if userName is null

  string? userName = null;
  int userNameLength = userName?.Length ?? 0; // Returns 0 if userName is null

  'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
  'ORIGINAL LINE: string? userName = null;
  Dim userName As String = Nothing
  Dim userNameLength As Integer = If(userName?.Length, 0) ' Returns 0 if userName is null

  $vbLabelText   $csharpLabel

• null-forgiving 運算子（!）：這個運算子是開發人員告訴編譯器變量不應被視為 null 的一種方式。 它有效地抑制了與可空引用類型相關的警告，幫助您避免任何不必要的編譯器警告提示潛在的 null 值。

  string? message = GetMessage(); // GetMessage could return null
  Console.WriteLine(message!); // We assert that message is not null

  string? message = GetMessage(); // GetMessage could return null
  Console.WriteLine(message!); // We assert that message is not null

  'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
  'ORIGINAL LINE: string? message = GetMessage();
  Dim message As String = GetMessage() ' GetMessage could return null
  'INSTANT VB TODO TASK: There is no VB equivalent to the C# 'null-forgiving operator':
  'ORIGINAL LINE: Console.WriteLine(message!);
  Console.WriteLine(message) ' We assert that message is not null

  $vbLabelText   $csharpLabel

在這種情況下，! 運算子告訴編譯器，在打印時您確信 message 不為 null，儘管有可能為 null。 當您希望確保方法的返回值正確處理並避免可能的 null 引用警告時，這特別重要。

了解這些運算子對於避免 null 引用異常和確保更乾淨、更安全的程式碼非常重要。 在正確的上下文中使用 ! 可以精簡程式碼而不犧牲安全性。

在 IronPDF 中的情境

使用 IronPDF，這是一個用於在 .NET 中創建和操作 PDF 文件的強大程式庫，開發人員可能經常遇到對象或方法結果返回 null 的情況。 例如，從文件加載 PDF 文件時，如果文件不存在或無法讀取，您可能會收到 null。 在這裡，null-forgiving 運算子（!）成為了一個有價值的工具，斷言變量不應為 null，允許您的程式碼在不需要進行過多 null 檢查的情況下進行。

安裝 IronPDF

Install-Package IronPdf

using IronPdf;

using IronPdf;

Imports IronPdf

範例 1：安全地渲染 PDF

讓我們來看看使用 IronPDF 渲染 PDF 文件的一個實際範例。 假設您有一個方法根據指定的文件路徑檢索 PDF。 如果路徑無效，該方法可能返回 null。 以下是如何有效處理此情境：

using IronPdf;

PdfDocument? pdf = PdfDocument.FromFile("example.pdf");
// Here we use the null-forgiving operator to assert that pdf is not null
pdf!.SaveAs("output.pdf");

using IronPdf;

PdfDocument? pdf = PdfDocument.FromFile("example.pdf");
// Here we use the null-forgiving operator to assert that pdf is not null
pdf!.SaveAs("output.pdf");

Imports IronPdf

Private pdf? As PdfDocument = PdfDocument.FromFile("example.pdf")
' Here we use the null-forgiving operator to assert that pdf is not null
'INSTANT VB TODO TASK: There is no VB equivalent to the C# 'null-forgiving operator':
'ORIGINAL LINE: pdf!.SaveAs("output.pdf");
pdf.SaveAs("output.pdf")

在此範例中，PdfDocument.FromFile(filePath) 方法嘗試從指定路徑加載 PDF。 ! 運算子表明您預期 pdf 為非 null。 然而，重要的是要注意，如果提供的文件路徑無效或文件無法讀取，則此程式碼將拋出運行時異常。

為提高安全性，您可能要在使用 ! 運算子之前進行檢查：

PdfDocument? pdf = PdfDocument.FromFile("example.pdf");
if (pdf != null)
{
    pdf.SaveAs("output.pdf");
}
else
{
    Console.WriteLine("Failed to load PDF document. Please check the file path.");
}

PdfDocument? pdf = PdfDocument.FromFile("example.pdf");
if (pdf != null)
{
    pdf.SaveAs("output.pdf");
}
else
{
    Console.WriteLine("Failed to load PDF document. Please check the file path.");
}

Dim pdf? As PdfDocument = PdfDocument.FromFile("example.pdf")
If pdf IsNot Nothing Then
	pdf.SaveAs("output.pdf")
Else
	Console.WriteLine("Failed to load PDF document. Please check the file path.")
End If

這種方法確保只有在 pdf 變量確實為非 null 時才調用方法，從而防止潛在的運行時錯誤。

範例 2：處理文件屬性

IronPDF 中的另一個常見使用情境涉及訪問文件屬性，例如 PDF 文件的標題或元數據。 如果 PDF 未設置標題，則 Title 屬性可能返回 null。 以下是使用 null-forgiving 運算子安全地檢索此屬性的方法：

using IronPdf;

PdfDocument? pdf = PdfDocument.FromFile("invoice.pdf");
// Assuming the title might be null, we use the null-forgiving operator
string? title = pdf!.MetaData.Title!;
Console.WriteLine($"Document Title: {title}");

using IronPdf;

PdfDocument? pdf = PdfDocument.FromFile("invoice.pdf");
// Assuming the title might be null, we use the null-forgiving operator
string? title = pdf!.MetaData.Title!;
Console.WriteLine($"Document Title: {title}");

Imports IronPdf

Private pdf? As PdfDocument = PdfDocument.FromFile("invoice.pdf")
' Assuming the title might be null, we use the null-forgiving operator
'INSTANT VB TODO TASK: There is no VB equivalent to the C# 'null-forgiving operator':
'ORIGINAL LINE: string? title = pdf!.MetaData.Title!;
'INSTANT VB WARNING: Nullable reference types have no equivalent in VB:
'ORIGINAL LINE: string? title = pdf.MetaData.Title;
Private title As String = pdf.MetaData.Title
Console.WriteLine($"Document Title: {title}")

在此範例中，pdf! 和 pdf.MetaData.Title! 都使用了 null-forgiving 運算子。 第一個確保 pdf 不是 null，第二個斷言 Title 屬性也不是 null。 然而，正如之前所述，建議小心； 如果其中任何一個值確實為 null，這段程式碼將導致運行時異常。

為了改進這個例子，可以提供一個替代值：

string title = pdf?.MetaData.Title ?? "Untitled Document"; // Fallback to "Untitled Document" if Title is null
Console.WriteLine($"Document Title: {title}");

string title = pdf?.MetaData.Title ?? "Untitled Document"; // Fallback to "Untitled Document" if Title is null
Console.WriteLine($"Document Title: {title}");

Dim title As String = If(pdf?.MetaData.Title, "Untitled Document") ' Fallback to "Untitled Document" if Title is null
Console.WriteLine($"Document Title: {title}")

這種替代方法確保您始終有有效的字符串可使用，顯著提高程式碼的穩定性。

避免常見陷阱

儘管 null-forgiving 運算子（!）是個強大的工具，但應該謹慎使用。 以下是一些避免常見陷阱的最佳做法：

1. 僅在確定時使用 !：僅當您確信變量為非 null 時才使用 null-forgiving 運算子。 過度依賴這個運算子會導致運行時異常，特別是當您的假設不正確時。 2. 與 null 条件檢查結合使用：在適用時，將 null-forgiving 運算子與 null 條件檢查結合使用以增強安全性。

2. 實施健全的錯誤處理：始終實施錯誤處理以管理意外的 null 值。 PDF 的創建和生成由 iText 7 支持，而 HTML 到 PDF 的轉換由 pdfHTML 支持。

   var title = pdf?.MetaData.Title!; // Safely access Title while asserting non-null

   var title = pdf?.MetaData.Title!; // Safely access Title while asserting non-null

   'INSTANT VB TODO TASK: There is no VB equivalent to the C# 'null-forgiving operator':
   'ORIGINAL LINE: var title = pdf?.MetaData.Title!;
   Dim title = pdf?.MetaData.Title ' Safely access Title while asserting non-null

   $vbLabelText   $csharpLabel

這可能涉及記錄錯誤或提供對用戶友好的回饋。 4. 在關鍵操作中使用 Try-Catch：在執行可能導致異常的操作時（如加載 PDF），考慮將其包裹在 try-catch 塊中以優雅地處理任何問題：

5. 記錄您的假設：在使用 null-forgiving 運算子時，註解程式碼以澄清您為什麼相信變量是非 null 的。

   try
   {
       var pdfDocument = PdfDocument.FromFile(filePath);
       // Proceed with processing
   }
   catch (Exception ex)
   {
       Console.WriteLine($"Error loading PDF: {ex.Message}");
   }

   try
   {
       var pdfDocument = PdfDocument.FromFile(filePath);
       // Proceed with processing
   }
   catch (Exception ex)
   {
       Console.WriteLine($"Error loading PDF: {ex.Message}");
   }

   Try
   	Dim pdfDocument = PdfDocument.FromFile(filePath)
   	' Proceed with processing
   Catch ex As Exception
   	Console.WriteLine($"Error loading PDF: {ex.Message}")
   End Try

   $vbLabelText   $csharpLabel

這種做法有助於將來的開發者（甚至是您自己）理解邏輯。 6. 定期進行程式碼評審：將程式碼評審納入您的開發流程，以檢查是否錯誤地使用了 !

運算子，確保開發人員遵循最佳實踐並減少編譯器警告中的誤報和漏報風險。 ### 程式碼檢視和可空警告

實施程式碼檢視是捕捉涉及可空警告的潛在問題的絕佳方法。

鼓勵團隊成員仔細檢查 ! 的用法，可以導致更可靠的程式碼，並幫助防止生產環境中的意外行為。 ### 專案文件的重要性

了解 C# 應用程式中專案文件的結構至關重要。

專案文件指定了您正在使用的庫，例如 IronPDF，以及任何特定的配置。 在使用 null-forgiving 運算子時，確保專案文件包含所有必要的引用，以防止編譯錯誤，特別是在使用複雜的庫時。 了解 C# 的驚嘆號（!）運算子在開發強健的應用時至關重要，尤其是在使用 IronPDF 庫時。