C# 中的 Try/Catch（開發者如何理解它）

什麼是例外，為什麼要處理它們？

在 C# 中，異常代表程式執行時發生的情況，它會干擾程式執行指令的標準進度。 當異常發生時，程式的流程會被轉移，如果異常未被處理，程式會突然終止。

異常處理是一種預測和管理這些破壞性事件的方法，可讓您的程式從意料之外的問題中恢復，並繼續如預期般執行。 透過使用 try 和 catch 區塊，您可以確保程式碼能夠優雅地處理錯誤，並提供使用者有意義的回饋。

嘗試區塊

try 區塊是您預期可能會產生異常的程式碼區段。 當您將程式碼包裝在 try 區塊中時，您是在告訴編譯器您想要處理該區塊中可能出現的異常。

以下是如何使用 try 區塊的基本範例：

try
{
    // Code that may generate an exception
}
catch (Exception ex)
{
    // Handle the exception
}

try
{
    // Code that may generate an exception
}
catch (Exception ex)
{
    // Handle the exception
}

Catch 區塊擷取異常

catch 語句與 try 區塊結合使用，以處理異常。 當異常發生在 try 區塊中時，程式執行會跳到適當的 catch 區塊，您可以在此指定程式應該如何回應異常。

要捕捉異常，您需要在 try 區塊之後立即建立 catch 區塊。 catch 區塊通常包含一個參數，代表捕獲的異常。

以下是執行中的 catch statement 範例：

try
{
    int result = 10 / 0;
}
catch (DivideByZeroException ex)
{
    Console.WriteLine("An error occurred: " + ex.Message);
}

try
{
    int result = 10 / 0;
}
catch (DivideByZeroException ex)
{
    Console.WriteLine("An error occurred: " + ex.Message);
}

在這個範例中，try 區塊內的程式碼試圖除以零，這將會產生 DivideByZeroException 。 接著 catch 區塊會處理異常，並顯示一則訊息給使用者。

多個 Catch 區塊處理不同的異常

有時候，您的 try 區塊可能會產生不同類型的可能異常。 在這種情況下，您可以使用多個 catch 區塊分別處理每種異常類型。

以下範例展示多重 catch 區塊的使用：

try
{
    int[] numbers = new int[7];
    numbers[12] = 70; // This line will throw an exception
}
catch (IndexOutOfRangeException ex)
{
    Console.WriteLine("An index out of range error occurred: " + ex.Message);
}
catch (Exception e)
{
    Console.WriteLine("An unexpected error occurred: " + e.Message);
}

try
{
    int[] numbers = new int[7];
    numbers[12] = 70; // This line will throw an exception
}
catch (IndexOutOfRangeException ex)
{
    Console.WriteLine("An index out of range error occurred: " + ex.Message);
}
catch (Exception e)
{
    Console.WriteLine("An unexpected error occurred: " + e.Message);
}

在這個範例中，try 區塊內的程式碼嘗試為不存在的陣列索引指定值，產生 IndexOutOfRangeException。 第一個 catch 區塊會處理這個特定的異常，而第二個 catch 區塊則會捕捉可能發生的任何其他異常。

請記住，當使用多重 catch 區塊時，請務必從最特殊的異常類型到最一般的異常類型順序排列。

Exception Filters 在 Catch 區塊中加入條件。

Exception filters 允許您在 catch 區塊中加入條件，讓您只有在符合特定條件時才能捕捉異常。 若要使用例外篩選器，請在 catch 語句中加入 when 關鍵字，並在其後接著條件。

以下範例展示了例外過濾器的使用：

try
{
    int result = 10 / 0;
}
catch (DivideByZeroException ex) when (ex.Message.Contains("divide"))
{
    Console.WriteLine("An error occurred: " + ex.Message);
}
catch (DivideByZeroException ex)
{
    Console.WriteLine("A different divide by zero error occurred: " + ex.Message);
}

try
{
    int result = 10 / 0;
}
catch (DivideByZeroException ex) when (ex.Message.Contains("divide"))
{
    Console.WriteLine("An error occurred: " + ex.Message);
}
catch (DivideByZeroException ex)
{
    Console.WriteLine("A different divide by zero error occurred: " + ex.Message);
}

在上面的範例中，只有當異常訊息中包含"除法"一詞時，第一個 catch 區塊才會處理 DivideByZeroException 。 如果不符合條件，第二個 catch 區塊會處理異常。

最後區塊確保程式碼的執行

在某些情況下，您可能想要確保執行特定的程式碼，不論是否發生異常。 為了達到此目的，您可以使用 finally 區塊。

finally 區塊放置在 try 和 catch 區塊之後，無論是否發生異常，該區塊始終被執行。

以下是一個示範使用 finally 區塊的範例：

try
{
    int result = 10 / 2;
}
catch (DivideByZeroException ex)
{
    Console.WriteLine("An error occurred: " + ex.Message);
}
finally
{
    Console.WriteLine("This line will always be executed.");
}

try
{
    int result = 10 / 2;
}
catch (DivideByZeroException ex)
{
    Console.WriteLine("An error occurred: " + ex.Message);
}
finally
{
    Console.WriteLine("This line will always be executed.");
}

在上面的範例中，即使 try 區塊中的程式碼沒有產生異常，finally 區塊仍會執行。

自訂例外：根據您的需求量身打造例外。

有時候，您可能想要建立自己的自訂異常，以處理程式碼中的特定異常。 為此，您可以建立一個繼承自 Exception 類的新類。

以下是建立自訂例外的範例：

public class CustomException : Exception
{
    public CustomException(string errorMessage) : base(errorMessage)
    {
    }
}

public class CustomException : Exception
{
    public CustomException(string errorMessage) : base(errorMessage)
    {
    }
}

現在，您可以在 try 和 catch 區塊中使用此自訂異常，就像這樣：

try
{
    throw new CustomException("This is a custom exception.");
}
catch (CustomException ex)
{
    Console.WriteLine("A custom exception occurred: " + ex.Message);
}

try
{
    throw new CustomException("This is a custom exception.");
}
catch (CustomException ex)
{
    Console.WriteLine("A custom exception occurred: " + ex.Message);
}

在這個範例中，try 區塊會丟出一個 CustomException 範例，然後由 catch 區塊捕獲並處理。

IronPDF：將 PDF 功能與例外處理整合在一起。

進一步了解 IronPDF 是一個常用的函式庫，用於在 C# 中建立、編輯 PDF 檔案以及從 PDF 檔案中擷取內容。 在本節中，我們將探討如何將 IronPDF 與您的 try-catch 異常處理方法相整合，從而優雅地處理潛在錯誤。

Install-Package IronPdf

using IronPdf;
using System;

try
{
    var renderer = new ChromePdfRenderer();
    string html = "Hello, World!";
    PdfDocument PDF = renderer.RenderHtmlAsPdf(html);
    PDF.SaveAs("output.PDF");
    Console.WriteLine("PDF created successfully.");
}
catch (Exception ex)
{
    Console.WriteLine("An unexpected error occurred: " + ex.Message);
}

using IronPdf;
using System;

try
{
    var renderer = new ChromePdfRenderer();
    string html = "Hello, World!";
    PdfDocument PDF = renderer.RenderHtmlAsPdf(html);
    PDF.SaveAs("output.PDF");
    Console.WriteLine("PDF created successfully.");
}
catch (Exception ex)
{
    Console.WriteLine("An unexpected error occurred: " + ex.Message);
}

using IronPdf;
using System;
using System.IO;

try
{
    string pdfPath = "input.PDF";
    if (File.Exists(pdfPath))
    {
        PdfDocument PDF = PdfDocument.FromFile(pdfPath);
        string extractedText = PDF.ExtractAllText();
        Console.WriteLine("Text extracted successfully: " + extractedText);
    }
    else
    {
        Console.WriteLine("The specified PDF file does not exist.");
    }
}
catch (Exception ex)
{
    Console.WriteLine("An unexpected error occurred: " + ex.Message);
}

using IronPdf;
using System;
using System.IO;

try
{
    string pdfPath = "input.PDF";
    if (File.Exists(pdfPath))
    {
        PdfDocument PDF = PdfDocument.FromFile(pdfPath);
        string extractedText = PDF.ExtractAllText();
        Console.WriteLine("Text extracted successfully: " + extractedText);
    }
    else
    {
        Console.WriteLine("The specified PDF file does not exist.");
    }
}
catch (Exception ex)
{
    Console.WriteLine("An unexpected error occurred: " + ex.Message);
}