Try/Catch in C#（開發者的工作原理）

嘗試區塊

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
}

Try
	' Code that may generate an exception
Catch ex As Exception
	' Handle the exception
End Try

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
	Dim result As Integer = 10 \ 0
Catch ex As DivideByZeroException
	Console.WriteLine("An error occurred: " & ex.Message)
End Try

在這個範例中，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
	Dim numbers(6) As Integer
	numbers(12) = 70 ' This line will throw an exception
Catch ex As IndexOutOfRangeException
	Console.WriteLine("An index out of range error occurred: " & ex.Message)
Catch e As Exception
	Console.WriteLine("An unexpected error occurred: " & e.Message)
End Try

在這個例子中，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);
}

Try
	Dim result As Integer = 10 \ 0
Catch ex As DivideByZeroException When ex.Message.Contains("divide")
	Console.WriteLine("An error occurred: " & ex.Message)
Catch ex As DivideByZeroException
	Console.WriteLine("A different divide by zero error occurred: " & ex.Message)
End Try

在上面的例子中，只有當異常訊息包含單字"divide"時，第一個 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
	Dim result As Integer = 10 \ 2
Catch ex As DivideByZeroException
	Console.WriteLine("An error occurred: " & ex.Message)
Finally
	Console.WriteLine("This line will always be executed.")
End Try

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

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

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

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

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

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

Public Class CustomException
	Inherits Exception

	Public Sub New(ByVal errorMessage As String)
		MyBase.New(errorMessage)
	End Sub
End Class

現在，您可以在 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
	Throw New CustomException("This is a custom exception.")
Catch ex As CustomException
	Console.WriteLine("A custom exception occurred: " & ex.Message)
End Try

在這個範例中，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);
}

Imports IronPdf
Imports System

Try
	Dim renderer = New ChromePdfRenderer()
	Dim html As String = "Hello, World!"
	Dim PDF As PdfDocument = renderer.RenderHtmlAsPdf(html)
	PDF.SaveAs("output.PDF")
	Console.WriteLine("PDF created successfully.")
Catch ex As Exception
	Console.WriteLine("An unexpected error occurred: " & ex.Message)
End Try

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);
}

Imports IronPdf
Imports System
Imports System.IO

Try
	Dim pdfPath As String = "input.PDF"
	If File.Exists(pdfPath) Then
		Dim PDF As PdfDocument = PdfDocument.FromFile(pdfPath)
		Dim extractedText As String = PDF.ExtractAllText()
		Console.WriteLine("Text extracted successfully: " & extractedText)
	Else
		Console.WriteLine("The specified PDF file does not exist.")
	End If
Catch ex As Exception
	Console.WriteLine("An unexpected error occurred: " & ex.Message)
End Try