C# try catch finally（開発者向けの仕組み）

C#では、try-catch ブロックはコードの実行中に発生する可能性のある例外を処理することを可能にします。 tryブロックのセクションには例外をスローする可能性のあるコードが含まれており、catchブロックが例外を処理します。 この構造は、例外を穏やかに処理し、呼び出しスタックを上に伝播させることを防ぐことで、アプリケーションのクラッシュを防ぐために重要です。

try ブロックは、例外をスローする可能性のあるコードを配置する場所です。 このブロックはセーフガードとして働き、エラーを監視すべきコードのセクションを指定できるようにします。 tryブロックの部分が例外をスローした場合、制御は直ちに対応するcatchブロックに移ります。

catch ブロックはtryブロックの後に続き、tryブロックコードでスローされた例外を処理するために使用されます。 異なる種類の例外を個別に処理するために、複数のcatchブロックを設定することができます。 各catchブロックは処理する例外のタイプを指定し、例えばエラーのログ記録やエラーについてのユーザーフレンドリーなメッセージの表示など、例外を処理するためのコードを含みます。

using IronPdf;
public static void Main(string[] args)
{
    try
    {
        // Create a PDF renderer using Chrome.
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        // Render an HTML file as a PDF.
        var pdf = renderer.RenderHtmlFileAsPdf("Example.html");
        // Save the PDF to the specified file path.
        pdf.SaveAs("output.pdf");
    }
    catch (FileNotFoundException ex)
    {
        // Handle file not found exception
        Console.WriteLine("File not found: " + ex.Message);
    }
    catch (UnauthorizedAccessException ex)
    {
        // Handle unauthorized access exception
        Console.WriteLine("Error: Access to the file is denied. " + ex.Message);
    }
    catch (Exception ex)
    {
        // Handle any other exceptions
        Console.WriteLine("An unexpected error occurred: " + ex.Message);
    }
}

using IronPdf;
public static void Main(string[] args)
{
    try
    {
        // Create a PDF renderer using Chrome.
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        // Render an HTML file as a PDF.
        var pdf = renderer.RenderHtmlFileAsPdf("Example.html");
        // Save the PDF to the specified file path.
        pdf.SaveAs("output.pdf");
    }
    catch (FileNotFoundException ex)
    {
        // Handle file not found exception
        Console.WriteLine("File not found: " + ex.Message);
    }
    catch (UnauthorizedAccessException ex)
    {
        // Handle unauthorized access exception
        Console.WriteLine("Error: Access to the file is denied. " + ex.Message);
    }
    catch (Exception ex)
    {
        // Handle any other exceptions
        Console.WriteLine("An unexpected error occurred: " + ex.Message);
    }
}

FileNotFoundExceptionの例

IronPDFを使用してPDFを生成する際には、プロセス中に発生する可能性のあるさまざまな例外を予見し、処理することが重要です。 適切な例外処理コードの実装は、アプリケーションのクラッシュを防ぐだけでなく、エラーに優美に対応する方法を提供し、アプリケーションの全体的な堅牢性とユーザーエクスペリンスを向上させます。 スローされる可能性のある一般的な例外には以下のようなものがあります：

• FileNotFoundException: この例外は、指定されたファイルパスに存在しないファイルをIronPDFで読み込もうとしたときに発生します。 これに対処する一つの方法としては、ファイルの存在を確認するためにFile.Exists(path) を使用するか、ifステートメントブロックに操作をラップしてファイルが存在するかを確認することがあります。
• InvalidOperationException: これは、現在の操作に対してPDFドキュメントの状態が無効なときに発生します。 例えば、完全にロードまたはレンダリングされていないPDFに対して操作を試みる場合などです。
• UnauthorizedAccessException: この例外は、アプリケーションが指定されたファイルまたはディレクトリへのアクセス権限を持っていないときに発生します。 これは、制限のあるファイル権限や読み取り専用ファイルへの書き込みを試みた際に発生することがあります。例えば、アプリケーションが書き込み権限を持たないディレクトリに出力PDFファイルを保存しようとした場合です。

IronPDF固有の例外クラスには以下のようなものがあります：

• IronPdfAssemblyVersionMismatchException: IronPDFのデプロイメント中にアセンブリを読み込んでいる際に発生するエラーを指します。
• IronPdfNativeException: これはIronPDFのネイティブコードで発生する可能性のあるエラーを表します。
• IronPdfProductException: IronPDFの実行中に発生する可能性のあるエラーを表します。

using IronPdf;
using IronPdf.Exceptions;
public static void Main(string[] args)
{
    try
    {
        // Set the IronPDF license key
        IronPdf.License.LicenseKey = "license-key";
        // Create a PDF renderer
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        // Generate PDF from HTML
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1>");
        // Save the PDF
        pdf.SaveAs("output.pdf");
    }
    catch (IronPdfProductException ex)
    {
        // Handle PDF generation specific exceptions
        Console.WriteLine("Error During IronPDF execution: " + ex.Message);
    }
    catch (Exception ex)
    {
        // Handle general exceptions
        Console.WriteLine("An unexpected error occurred: " + ex.Message);
    }
}

using IronPdf;
using IronPdf.Exceptions;
public static void Main(string[] args)
{
    try
    {
        // Set the IronPDF license key
        IronPdf.License.LicenseKey = "license-key";
        // Create a PDF renderer
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        // Generate PDF from HTML
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1>");
        // Save the PDF
        pdf.SaveAs("output.pdf");
    }
    catch (IronPdfProductException ex)
    {
        // Handle PDF generation specific exceptions
        Console.WriteLine("Error During IronPDF execution: " + ex.Message);
    }
    catch (Exception ex)
    {
        // Handle general exceptions
        Console.WriteLine("An unexpected error occurred: " + ex.Message);
    }
}

出力

IronPDFでの例外処理の例としては、ライセンスキーが誤っている、または欠けているという場合があります。 その場合、例外処理プロセスの一部としてIronPdfProductExceptionを使用することで、マッチングするエラーメッセージを表示します。

ファイル操作やリソース管理を伴うシナリオでは、finallyブロックがプロセス中にエラーが発生しても全てのリソースが適切に解放されることを保証します。

ファイルを操作する際には、読み取りまたは書き込みのためにファイルストリームを開くのが一般的です。 ファイルを処理中に例外が発生した場合、ストリームを閉じ忘れるとファイルがロックされたり、その他の問題を引き起こす可能性があります。 finallyブロックは、ファイルストリームが常に閉じられてリソースが解放されることを保証します。

public static void Main(string[] args)
{
    FileStream fileStream = null;
    try
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        // Generate PDF from HTML
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1>");
        pdf.SaveAs("output.pdf");
        pdfGenerated = true;
    }
    catch (IronPdf.Exceptions.IronPdfProductException ex)
    {
        // Handle PDF generation specific exceptions
        Console.WriteLine("Error During IronPDF execution: " + ex.Message);
    }
    catch (Exception ex)
    {
        // Handle general exceptions to avoid any unhandled exception issues
        Console.WriteLine("An unexpected error occurred: " + ex.Message);
    }
    finally
    {
        // Cleanup resources if necessary
        if (fileStream != null)
        {
            fileStream.Close();
            fileStream.Dispose();
        }
    }
}

public static void Main(string[] args)
{
    FileStream fileStream = null;
    try
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        // Generate PDF from HTML
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello, World!</h1>");
        pdf.SaveAs("output.pdf");
        pdfGenerated = true;
    }
    catch (IronPdf.Exceptions.IronPdfProductException ex)
    {
        // Handle PDF generation specific exceptions
        Console.WriteLine("Error During IronPDF execution: " + ex.Message);
    }
    catch (Exception ex)
    {
        // Handle general exceptions to avoid any unhandled exception issues
        Console.WriteLine("An unexpected error occurred: " + ex.Message);
    }
    finally
    {
        // Cleanup resources if necessary
        if (fileStream != null)
        {
            fileStream.Close();
            fileStream.Dispose();
        }
    }
}

Finallyブロック実行の出力

IronPDFでのファイル操作において、FileNotFoundException や UnauthorizedAccessException などの例外処理が重要です。 これらの例外は、ファイルが欠けている場合や権限が制限されている場合に頻繁に発生します。 これらの例外を適切に処理することは、ファイルパスや可用性、アクセス権に問題がある場合に発生することが多いため、アプリケーションの堅牢性と信頼性を維持するために欠かせません。

using IronPdf;
using System.IO;
using IronPdf.Exceptions;
public static void Main(string[] args)
{
    try
    {
        // Generate PDF from an RTF file
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderRtfFileAsPdf("filePath");
        pdf.SaveAs("output.pdf");
    }
    catch (IronPdf.Exceptions.IronPdfProductException ex)
    {
        // Handle PDF generation specific exceptions
        Console.WriteLine("Error During IronPDF execution: " + ex.Message);
    }
    catch (IOException ex)
    {
        int retries = 5;
        int delay = 1000; // Delay in milliseconds
        Console.WriteLine("IO Exception: " + ex.Message);
        retries--;
        if (retries > 0)
        {
            Console.WriteLine("File is in use. Retrying in " + delay + "ms...");
            System.Threading.Thread.Sleep(delay);
        }
        else
        {
            Console.WriteLine("Failed to access the file after multiple attempts.");
        }
    }
    catch (Exception ex)
    {
        // Handle general exceptions
        Console.WriteLine("An unexpected error occurred: " + ex.Message);
    }
    finally
    {
        // Delete the temporary file
        if (File.Exists("temp.txt"))
        {
            File.Delete("temp.txt");
            Console.WriteLine("Cleanup Complete!");
        }
    }
}

using IronPdf;
using System.IO;
using IronPdf.Exceptions;
public static void Main(string[] args)
{
    try
    {
        // Generate PDF from an RTF file
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderRtfFileAsPdf("filePath");
        pdf.SaveAs("output.pdf");
    }
    catch (IronPdf.Exceptions.IronPdfProductException ex)
    {
        // Handle PDF generation specific exceptions
        Console.WriteLine("Error During IronPDF execution: " + ex.Message);
    }
    catch (IOException ex)
    {
        int retries = 5;
        int delay = 1000; // Delay in milliseconds
        Console.WriteLine("IO Exception: " + ex.Message);
        retries--;
        if (retries > 0)
        {
            Console.WriteLine("File is in use. Retrying in " + delay + "ms...");
            System.Threading.Thread.Sleep(delay);
        }
        else
        {
            Console.WriteLine("Failed to access the file after multiple attempts.");
        }
    }
    catch (Exception ex)
    {
        // Handle general exceptions
        Console.WriteLine("An unexpected error occurred: " + ex.Message);
    }
    finally
    {
        // Delete the temporary file
        if (File.Exists("temp.txt"))
        {
            File.Delete("temp.txt");
            Console.WriteLine("Cleanup Complete!");
        }
    }
}

ファイルが見つからない場合の出力例

IOExceptionの出力例

IronPdfNativeExceptionによる予期せぬエラーの出力例

PDF処理中のエラーのログ記録はデバッグと監視にとって重要です。 それは発生した問題に関する詳細な情報をキャプチャし、問題を診断しアプリケーションの信頼性を向上させるのに非常に有用です。

using IronPdf;
using IronPdf.Logging;
public static void Main(string[] args)
{
    IronPdf.Logging.Logger.LogFilePath = "Default.log";
    IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;
    try
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlFileAsPdf("report.html");
        pdf.SaveAs("output.pdf");
    }
    catch (Exception ex)
    {
        // Log the exception
        IronSoftware.Logger.Log("PDF processing failed: " + ex.Message);
    }
    finally
    {
        Console.WriteLine("PDF processing attempt finished.");
    }
}

using IronPdf;
using IronPdf.Logging;
public static void Main(string[] args)
{
    IronPdf.Logging.Logger.LogFilePath = "Default.log";
    IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;
    try
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlFileAsPdf("report.html");
        pdf.SaveAs("output.pdf");
    }
    catch (Exception ex)
    {
        // Log the exception
        IronSoftware.Logger.Log("PDF processing failed: " + ex.Message);
    }
    finally
    {
        Console.WriteLine("PDF processing attempt finished.");
    }
}

コンソール出力

ログ出力

1. バックアップの作成:

   • PDFは最初にバックアップ場所(backupPdfPath)に保存されます。

2. 成功した操作:

   • PDF生成が成功した場合(pdfGenerated = true)、バックアップPDFは最終出力場所に移動されます。

3. 失敗時のロールバック:

   • 例外が発生し、pdfGeneratedがfalseのままである場合、finallyブロックでバックアップPDFを削除して、部分的な変更を元に戻します。
4. クリーンアップ:
   • 成功または失敗に関係なく、finallyブロックで一時ファイルは削除され、残ったファイルが残らないようにします。

このロールバックメカニズムを実装することで、PDF生成プロセス中にエラーが発生した場合でもファイルシステムが一貫した状態を保つことを保証します。

出力