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-Conditional運算子（?.）與Null-Forgiving運算子（!）

C#提供多種工具來管理空值狀態，了解它們的差異對於有效的編碼至關重要。 在這個情境中，兩個最重要的運算子是null-conditional運算子（?.）和null-forgiving運算子（!）。

• Null-Conditional運算子（?.）: 這個運算子允許安全地存取可能為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的方法。 它有效地抑制與可空引用型別相關的警告，幫助您避免任何不必要的編譯器警告。

  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。 這在您希望確保從方法返回的值被正確處理並避免任何可能的空引用警告時特別重要。

理解這些運算子對於避免空引用異常和確保更乾淨、更安全的程式碼至關重要。 在正確的情境下使用!可以簡化程式碼而不犧牲安全性。

與IronPDF的情境化

在使用IronPDF時，這是一個強大的用於在.NET中建立和操作PDF文件的程式庫，開發者可能經常遇到物件或方法結果為null的情況。 例如，當從文件中載入PDF文件時，如果文件不存在或無法讀取，您可能會收到null。 在此情境下，null-forgiving運算子（!）成為一個寶貴的工具，斷言變數不應為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-forgiving運算子與空值條件檢查結合使用，以提高安全性。 例如：

   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

3. 實施穩健的錯誤處理： 始終實施錯誤處理以管理意外的空值。 這可能包括記錄錯誤或提供使用者友好的反饋。

4. 對於關鍵操作，利用try-catch： 當執行可能導致異常的操作（如載入PDF）時，考慮將它們包裹在try-catch塊中，以優雅地處理任何問題：

   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

5. 記錄您的假設： 使用null-forgiving運算子時，請在程式碼中註解，說明為什麼認為變數為非null。 這一做法有助於未來的開發者（甚至是您自己）理解邏輯。

6. 進行定期程式碼審查： 在您的開發過程中引入程式碼審查, 以捕捉！的潛在誤用 運算子，確保開發者堅持最佳實踐並減少編譯器警告中的誤報和漏報風險。

程式碼審查與空值警告

實施程式碼審查是一種很好的方法來捕捉與空值警告相關的潛在問題。 鼓勵團隊成員仔細審查使用!的情況可以導致更可靠的程式碼並幫助防止在生產中意外行為。

專案文件的重要性

了解專案文件在C#應用程式中的結構至關重要。 專案文件指定您正在使用的程式庫，例如IronPDF，以及任何特定配置。 當使用null-forgiving運算子時，請確保專案文件中包含所有必要的引用，以防止編譯錯誤，特別是在使用複雜的程式庫時。