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-Forgiving运算符（!）

C#提供了多种工具来管理空值状态，了解它们之间的差异对于有效编码是至关重要的。 在这个情境中，有两个最重要的运算符是空条件运算符 (?.) 和 null-forgiving 运算符 (!)。

• 空条件运算符（?.）：此运算符允许安全访问可能为空的对象的属性或方法。 通过使用?.，您可以防止空状态异常，而无需显式检查对象是否为空。

  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运算符（!）：此运算符是开发人员告知编译器某个变量不应被视为空的一种方式。 它有效地抑制与可空引用类型相关的可空警告，帮助您避免任何关于潜在空值的不必要的编译器警告。

  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在打印时不是空的，尽管它可能为空。 这在您想确保方法的返回值被正确处理并避免任何可能的空引用警告时尤其重要。

了解这些运算符对于避免空引用异常并保证代码的清洁和安全至关重要。 在正确的上下文中使用!可以在不牺牲安全性的情况下简化代码。

与IronPDF的情景化

当使用IronPDF这样的强大库来在.NET中创建和处理PDF文件时，开发人员可能经常会遇到对象或方法结果可能返回空的情况。 例如，当从文件加载一个PDF文档时，如果文件不存在或无法读取，您可能会收到空值。 在这里，null-forgiving运算符（!）成为一个有价值的工具，确认变量不应为空，使您的代码能够在没有多余的空检查情况下继续。

安装 IronPDF。

Install-Package IronPdf

using IronPdf;

using IronPdf;

Imports IronPdf

示例1：安全渲染PDF

让我们来看一个使用IronPDF渲染PDF文档的实际示例。 假设您有一个方法，根据指定的文件路径检索一个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");

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为非空。 然而，重要的是要注意，如果提供的文件路径无效或文件无法读取，此代码会抛出一个运行时异常。

为了提高安全性，您可能希望在使用!运算符之前进行检查：

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变量确实为非空时才调用其方法，从而避免潜在的运行时错误。

示例2：处理文档属性

IronPDF中另一个常见的使用场景是访问文档属性，例如PDF文档的标题或元数据。 如果PDF没有设置标题，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}");

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不是空的，第二个确保Title属性也不是空的。 但是，与以前一样，要谨慎行事； 如果任一值确实为空，此代码将导致运行时异常。

为了改进此示例，您可以提供一个后备值：

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-forgiving运算符。 过多依赖此运算符如果您的假设不正确，会导致运行时异常。 2. 与空条件检查结合使用**：在适用时，将null-forgiving运算符与空条件检查结合使用以提高安全性。

2. 实施健壮的错误处理：始终实施错误处理以管理意外空值。 PDF创建和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运算符时，注释你的代码以澄清为什么你认为变量是非空的。

   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这样的库合作时。 这个运算符允许开发人员表达对其代码的信心，减少不必要的空检查，同时提高可读性。