C# の Try/Catch (開発者向けの仕組み)

例外とは何か、それを処理する理由

C#では、例外とは、プログラムが実行中に発生し、プログラムの標準的な命令実行の流れを妨げる出来事を指します。 例外が発生すると、プログラムの流れは転換され、例外が処理されない限り、プログラムは突然終了します。

例外処理は、これらの破壊的イベントを予測し管理する方法であり、プログラムが予期しない問題から回復し、意図どおりに続行できるようにします。 tryとcatchブロックを使用することで、コードがエラーを優雅に処理し、ユーザーに意味のあるフィードバックを提供することができます。

Tryブロック

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ステートメントは、例外を処理するためにtryブロックと共に使用されます。 tryブロック内で例外が発生すると、プログラムの実行は適切なcatchブロックにジャンプし、例外に対するプログラムの対応を指定することができます。

例外を捕捉するには、tryブロックの直後にcatchブロックを作成する必要があります。 catchブロックには通常、捕捉された例外を表すパラメータが含まれます。

アクション中のcatchステートメントの例を次に示します。

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ブロックが例外を処理し、ユーザーにメッセージを表示します。

異なる例外を処理する複数のキャッチブロック

場合によっては、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ブロックを使用する場合、常に最も特定の例外タイプから最も一般的なものへ順序を付けてください。

キャッチブロックに条件を追加する例外フィルター

例外フィルターを使用すると、特定の条件が満たされた場合のみ例外を捕捉するための条件をキャッチブロックに追加できます。 例外フィルターを使用するには、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

上記の例では、最初のcatchブロックは、例外メッセージに「divide」という単語が含まれている場合のみDivideByZeroExceptionを処理します。 条件が満たされない場合、二番目のキャッチブロックが例外を処理します。

最終的なコード実行を保証するFinallyブロック

場合によっては、例外の有無にかかわらず特定のコード片を実行したいことがあります。 これを達成するには、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ファイルを作成、編集、およびコンテンツを抽出するための人気のあるライブラリです。 このセクションでは、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