C# ConfigureAwait（開発者向けの仕組み）

非同期プログラミングとは何でしょうか?

非同期プログラミングとは、メインアプリケーションのスレッドと独立して特定の操作を実行できるコードの記述方法を指します。 これは、I/O操作などの待機が必要な長時間実行されるタスクに役立ちます。 これらのタスクを実行し、メインスレッドをブロックしないようにすることで、アプリケーションは実行を続けることができ、最終的にはアプリケーションのパフォーマンスと応答性を向上させます。

非同期コードにおけるConfigureAwaitの役割

ConfigureAwaitは、非同期プログラミングで継続がどのように実行されるかを制御するために使用されるメソッドです。 継続とは、待機式の後に実行されるコードのことで、デフォルトではawaitは現在のコンテキストをキャプチャし、そのコンテキストに継続を再利用しようとしますが、これが効果的でないことがあります。ConfigureAwaitは、継続がキャプチャされたコンテキストで実行されるべきかどうかを指定できます。キャプチャされるとConfigureAwait(true)、されないとConfigureAwait(false)となります。

ConfigureAwait(false)を使用することはデッドロックを回避するのに役立ちます。これは、現在の同期コンテキストをキャプチャしない設定をするためで、元のコンテキストに復帰することを試みません。 これにより、継続が元のコンテキストではなくスレッドプールのスレッドで実行され、メインスレッドがブロックされるのを防ぎます。

ConfigureAwait(false)は特にライブラリコードや、元のコンテキストに戻る必要のないケースで有用であり、コードが柔軟でデッドロックが発生しないことを保証します。

.NETプロジェクトでのIronPDFのセットアップ

.NETプロジェクトでIronPDFを使用開始するには、IronPDF NuGetパッケージをインストールして開始します。 これを行うには、ツール > NuGetパッケージマネージャー > NuGetパッケージマネージャーのソリューションに移動し、IronPDFを検索します:

または、パッケージマネージャーコンソールで次のコマンドを実行することでもできます。

Install-Package IronPdf

IronPDFをコードで使用し始めるには、コードファイルの先頭にusing IronPdf;を配置したことを確認してください。IronPDFを環境にセットアップするためのより包括的なガイドについては、getting startedページを参照してください。

IronPDFを使用した非同期PDFの生成

大容量のPDFファイルを生成する必要がある場合や複数の操作を同時に実行したい場合、PDFファイルを非同期で生成することは特に有益です。 IronPDFを使用することで、非同期でPDF関連のタスクを実行できます。これは次のような非同期コードになる場合があります:

using IronPdf;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        await GeneratePdfAsync();
    }

    static async Task GeneratePdfAsync()
    {
        // Create a new instance of ChromePdfRenderer.
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Example HTML content to be converted into a PDF.
        string htmlContent = "<h1>Hello World!</h1>";

        // Asynchronously render the HTML content as a PDF document.
        PdfDocument pdf = await renderer.RenderHtmlAsPdfAsync(htmlContent);

        // Asynchronously save the PDF document to a file.
        await Task.Run(() => pdf.SaveAs("outputAsync.pdf"));

        Console.WriteLine("Working!");
    }
}

using IronPdf;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        await GeneratePdfAsync();
    }

    static async Task GeneratePdfAsync()
    {
        // Create a new instance of ChromePdfRenderer.
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Example HTML content to be converted into a PDF.
        string htmlContent = "<h1>Hello World!</h1>";

        // Asynchronously render the HTML content as a PDF document.
        PdfDocument pdf = await renderer.RenderHtmlAsPdfAsync(htmlContent);

        // Asynchronously save the PDF document to a file.
        await Task.Run(() => pdf.SaveAs("outputAsync.pdf"));

        Console.WriteLine("Working!");
    }
}

Imports IronPdf
Imports System.Threading.Tasks

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		Await GeneratePdfAsync()
	End Function

	Private Shared Async Function GeneratePdfAsync() As Task
		' Create a new instance of ChromePdfRenderer.
		Dim renderer As New ChromePdfRenderer()

		' Example HTML content to be converted into a PDF.
		Dim htmlContent As String = "<h1>Hello World!</h1>"

		' Asynchronously render the HTML content as a PDF document.
		Dim pdf As PdfDocument = Await renderer.RenderHtmlAsPdfAsync(htmlContent)

		' Asynchronously save the PDF document to a file.
		Await Task.Run(Function() pdf.SaveAs("outputAsync.pdf"))

		Console.WriteLine("Working!")
	End Function
End Class

このコードでは、GeneratePdfAsync()メソッドでPDFドキュメントを非同期に作成しています。 ChromePdfRendererがHTMLコンテンツからPDFファイルを作成するためのレンダラーを作成するために使用されます。 The PdfDocument class is used to create a PDF from the provided HTML string, however, you could also use it to create the PDF from an HTML file, URL, image, and more. IronPDFでPDFを生成するさまざまな方法については、PDF生成のhow-toセクションを確認してください。

大容量PDFファイルを非同期で処理する

using IronPdf;
using System.Threading.Tasks;
using System.IO;
using System;

class Program
{
    static async Task Main(string[] args)
    {
        await LongPdfTask();
    }

    static async Task LongPdfTask()
    {
        try
        {
            // Initialize IronPDF's PdfDocument asynchronously.
            PdfDocument pdf = await Task.Run(() => PdfDocument.FromFile("Sample.pdf")).ConfigureAwait(false);

            // Extract text from PDF asynchronously with ConfigureAwait to prevent context capture.
            string text = await Task.Run(() => pdf.ExtractAllText()).ConfigureAwait(false);

            // Write the extracted text to a file asynchronously.
            await Task.Run(() => File.WriteAllText("extractedText.txt", text)).ConfigureAwait(false);

            Console.WriteLine("Extraction complete!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error in LongPdfTask: {ex.Message}");
        }
    }
}

using IronPdf;
using System.Threading.Tasks;
using System.IO;
using System;

class Program
{
    static async Task Main(string[] args)
    {
        await LongPdfTask();
    }

    static async Task LongPdfTask()
    {
        try
        {
            // Initialize IronPDF's PdfDocument asynchronously.
            PdfDocument pdf = await Task.Run(() => PdfDocument.FromFile("Sample.pdf")).ConfigureAwait(false);

            // Extract text from PDF asynchronously with ConfigureAwait to prevent context capture.
            string text = await Task.Run(() => pdf.ExtractAllText()).ConfigureAwait(false);

            // Write the extracted text to a file asynchronously.
            await Task.Run(() => File.WriteAllText("extractedText.txt", text)).ConfigureAwait(false);

            Console.WriteLine("Extraction complete!");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error in LongPdfTask: {ex.Message}");
        }
    }
}

Imports IronPdf
Imports System.Threading.Tasks
Imports System.IO
Imports System

Friend Class Program
	Shared Async Function Main(ByVal args() As String) As Task
		Await LongPdfTask()
	End Function

	Private Shared Async Function LongPdfTask() As Task
		Try
			' Initialize IronPDF's PdfDocument asynchronously.
			Dim pdf As PdfDocument = Await Task.Run(Function() PdfDocument.FromFile("Sample.pdf")).ConfigureAwait(False)

			' Extract text from PDF asynchronously with ConfigureAwait to prevent context capture.
			Dim text As String = Await Task.Run(Function() pdf.ExtractAllText()).ConfigureAwait(False)

			' Write the extracted text to a file asynchronously.
			Await Task.Run(Sub() File.WriteAllText("extractedText.txt", text)).ConfigureAwait(False)

			Console.WriteLine("Extraction complete!")
		Catch ex As Exception
			Console.WriteLine($"Error in LongPdfTask: {ex.Message}")
		End Try
	End Function
End Class

ConfigureAwait(true)対 ConfigureAwait(false)を使用するタイミング

ConfigureAwait(false)は、ライブラリコードやバックグラウンド処理をしているときに、同期コンテキストを維持する必要がない場合に最適です。 通常、これはサーバーサイドコードでパフォーマンスが重要な場合に使用します。 ConfigureAwait(false)を使用すると、await操作が終了したときに、継続が必ずしも非同期操作を開始したスレッドで実行されません。

PDF処理に関しては、ConfigureAwait(false)を実装することで、コンテキストの切り替えによるボトルネックを回避し、複数のPDF処理タスクを実行する際のパフォーマンスを最大化するのに役立ちます。 また、コンソールアプリケーションやバックグラウンドサービスで作業をしている場合に、コンテキストの切り替えが不要になる状況でも、アプリケーションの効率を維持するのに役立ちます。

ConfigureAwait(true)は、コードの単体テストやASP.NETアプリケーションでのUIや同期コンテキストが必要な場合に最適ですが、不適切に使用するとデッドロックを引き起こす可能性があります。 たとえば、UIの更新やhttpcontextへのアクセスを行う場合などで使用されます。 ConfigureAwait(true)はデフォルトの動作で、そのままConfigureAwaitと書くこともできます。

PDF処理タスクで使用する場合、UIとしっかり統合されたケース（WPF, WinFormsなどのUIアプリケーションを使用する際）で、同期コンテキストをキャプチャしてこれらの更新がUIスレッドで起こることを確認する必要がある時に特に有益です。 特定のスレッドで実行されなければならないスレッド関連の操作においても有益です。

非同期IronPDF操作における例外処理

非同期プログラミングでの例外処理は重要な点であり、慎重な考慮が必要です。未捕捉の例外はアプリケーションを停止させる可能性があります。 非同期コードの周りにtry-catchブロックを配置することは、予期しない例外をうまく処理するための良い方法です。

例えば：

public async Task SafeGeneratePdfAsync()
{
    try
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Asynchronously render HTML as PDF and do not capture the context
        PdfDocument pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Error Handling</h1>").ConfigureAwait(false);

        // Asynchronously save PDF to file
        await Task.Run(() => pdf.SaveAs("output.pdf")).ConfigureAwait(false);
    }
    catch (Exception ex)
    {
        Console.WriteLine($"An error occurred: {ex.Message}");
    }
}

public async Task SafeGeneratePdfAsync()
{
    try
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Asynchronously render HTML as PDF and do not capture the context
        PdfDocument pdf = await renderer.RenderHtmlAsPdfAsync("<h1>Error Handling</h1>").ConfigureAwait(false);

        // Asynchronously save PDF to file
        await Task.Run(() => pdf.SaveAs("output.pdf")).ConfigureAwait(false);
    }
    catch (Exception ex)
    {
        Console.WriteLine($"An error occurred: {ex.Message}");
    }
}

Public Async Function SafeGeneratePdfAsync() As Task
	Try
		Dim renderer As New ChromePdfRenderer()

		' Asynchronously render HTML as PDF and do not capture the context
		Dim pdf As PdfDocument = Await renderer.RenderHtmlAsPdfAsync("<h1>Error Handling</h1>").ConfigureAwait(False)

		' Asynchronously save PDF to file
		Await Task.Run(Function() pdf.SaveAs("output.pdf")).ConfigureAwait(False)
	Catch ex As Exception
		Console.WriteLine($"An error occurred: {ex.Message}")
	End Try
End Function

ConfigureAwait(false)を使用した継続タスクを使用する際には、try-catch以内で例外を処理するか、Task.ContinueWithを使用している場合は、Task.Exceptionプロパティで処理することができます。

このようなコードを記述する例としては次のようになります:

class Program
{
    public static async Task Main(string[] args)
    {
        await ProcessPdfWithContinuationAsync();
    }

    static Task ProcessPdfWithContinuationAsync()
    {
        return Task.Run(() => PdfDocument.FromFile("Sample.pdf"))
            .ContinueWith(pdfTask =>
            {
                if (pdfTask.IsFaulted)
                {
                    // Handle exceptions from loading the PDF
                    Console.WriteLine($"Error loading PDF: {pdfTask.Exception?.GetBaseException().Message}");
                    return;
                }
                var pdf = pdfTask.Result;
                // Extract text asynchronously with exception handling
                Task.Run(() => pdf.ExtractAllText())
                    .ContinueWith(extractTask =>
                    {
                        if (extractTask.IsFaulted)
                        {
                            // Handle exceptions from extracting text
                            Console.WriteLine($"Error extracting text: {extractTask.Exception?.GetBaseException().Message}");
                            return;
                        }
                        // Proceed if text extraction is successful
                        Console.WriteLine("Extracted text:");
                        Console.WriteLine(extractTask.Result);
                    }, TaskContinuationOptions.OnlyOnRanToCompletion);
            }, TaskContinuationOptions.OnlyOnRanToCompletion);
    }
}

class Program
{
    public static async Task Main(string[] args)
    {
        await ProcessPdfWithContinuationAsync();
    }

    static Task ProcessPdfWithContinuationAsync()
    {
        return Task.Run(() => PdfDocument.FromFile("Sample.pdf"))
            .ContinueWith(pdfTask =>
            {
                if (pdfTask.IsFaulted)
                {
                    // Handle exceptions from loading the PDF
                    Console.WriteLine($"Error loading PDF: {pdfTask.Exception?.GetBaseException().Message}");
                    return;
                }
                var pdf = pdfTask.Result;
                // Extract text asynchronously with exception handling
                Task.Run(() => pdf.ExtractAllText())
                    .ContinueWith(extractTask =>
                    {
                        if (extractTask.IsFaulted)
                        {
                            // Handle exceptions from extracting text
                            Console.WriteLine($"Error extracting text: {extractTask.Exception?.GetBaseException().Message}");
                            return;
                        }
                        // Proceed if text extraction is successful
                        Console.WriteLine("Extracted text:");
                        Console.WriteLine(extractTask.Result);
                    }, TaskContinuationOptions.OnlyOnRanToCompletion);
            }, TaskContinuationOptions.OnlyOnRanToCompletion);
    }
}

Friend Class Program
	Public Shared Async Function Main(ByVal args() As String) As Task
		Await ProcessPdfWithContinuationAsync()
	End Function

	Private Shared Function ProcessPdfWithContinuationAsync() As Task
		Return Task.Run(Function() PdfDocument.FromFile("Sample.pdf")).ContinueWith(Sub(pdfTask)
				If pdfTask.IsFaulted Then
					' Handle exceptions from loading the PDF
					Console.WriteLine($"Error loading PDF: {pdfTask.Exception?.GetBaseException().Message}")
					Return
				End If
				Dim pdf = pdfTask.Result
				' Extract text asynchronously with exception handling
				Task.Run(Function() pdf.ExtractAllText()).ContinueWith(Sub(extractTask)
						If extractTask.IsFaulted Then
							' Handle exceptions from extracting text
							Console.WriteLine($"Error extracting text: {extractTask.Exception?.GetBaseException().Message}")
							Return
						End If
						' Proceed if text extraction is successful
						Console.WriteLine("Extracted text:")
						Console.WriteLine(extractTask.Result)
				End Sub, TaskContinuationOptions.OnlyOnRanToCompletion)
		End Sub, TaskContinuationOptions.OnlyOnRanToCompletion)
	End Function
End Class

IronPDFの重要機能と利点

IronPDFは、すべてのPDF関連タスクに対して豊富な機能セットを提供する強力なC# PDFライブラリです。 .NET 8, 7, 6, .NET Core, Standard, Frameworkをフルサポートし、Windows, Linux, Mac, Docker, Azure, AWSなど、さまざまなアプリ環境で実行できますので、IronPDFを希望する環境で最大限に利用することができます。

With IronPDF, you can generate PDFs from various file and data types; including HTML files, HTML string, URLs, images, DOCX, and RTF, often in just a few lines of code! It can handle the formatting of your PDF documents, apply custom watermarks, merge and split PDFs, handle PDF encryption and security, and more.

非同期プログラミングに対するIronPDFのサポート

IronPDFは多くの操作に対して非同期メソッドを提供し、開発者がシームレスにasync/awaitパターンを活用できるようにしています。 このサポートにより、パフォーマンスが重要なアプリケーションにIronPDFを組み込んで応答性を損なうことなく統合でき、非同期の環境でPDF関連のタスクを実行する開発者にとって非常に価値のあるPDFツールになります。

ライセンス

IronPDFをご自分で試してその幅広い機能を探求したいとお考えの場合は、無料試用期間が用意されているので簡単に行えます。 インストールが簡単で迅速なので、PDFプロジェクトでIronPDFをすぐに使い始めることができます。さらにその強力な機能を活用してPDFを向上させたい方は？ ライセンスは$liteLicenseから始まり、30日間の返金保証、1年間の製品サポートとアップデート、そして永久ライセンス（煩わしい定期料金なし！）が付いてきます。

PDFを非同期で生成するには、IronPDFを使用してHTMLファイルをレンダリングするコードを実行し、結果を保存します。この際、ConfigureAwait(false)を使用して継続が不要に元の同期コンテキストに切り替わらないようにします。

using IronPdf;
using System.Threading.Tasks;
using System;

class Program
{
    public static async Task Main(string[] args)
    {
        await CreateInvoicePdfAsync();
    }

    static async Task<string> CreateInvoicePdfAsync()
    {
        // Instance of ChromePdfRenderer to convert HTML to PDF
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        try
        {
            // Render HTML file as a PDF asynchronously without capturing the context.
            var pdf = await renderer.RenderHtmlFileAsPdfAsync("example.html").ConfigureAwait(false);

            // Save the generated PDF asynchronously.
            await Task.Run(() => pdf.SaveAs("invoice.pdf")).ConfigureAwait(false);

            return "invoice.pdf";
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error generating PDF: {ex.Message}");
            return null;
        }
    }
}

using IronPdf;
using System.Threading.Tasks;
using System;

class Program
{
    public static async Task Main(string[] args)
    {
        await CreateInvoicePdfAsync();
    }

    static async Task<string> CreateInvoicePdfAsync()
    {
        // Instance of ChromePdfRenderer to convert HTML to PDF
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        try
        {
            // Render HTML file as a PDF asynchronously without capturing the context.
            var pdf = await renderer.RenderHtmlFileAsPdfAsync("example.html").ConfigureAwait(false);

            // Save the generated PDF asynchronously.
            await Task.Run(() => pdf.SaveAs("invoice.pdf")).ConfigureAwait(false);

            return "invoice.pdf";
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error generating PDF: {ex.Message}");
            return null;
        }
    }
}

Imports IronPdf
Imports System.Threading.Tasks
Imports System

Friend Class Program
	Public Shared Async Function Main(ByVal args() As String) As Task
		Await CreateInvoicePdfAsync()
	End Function

	Private Shared Async Function CreateInvoicePdfAsync() As Task(Of String)
		' Instance of ChromePdfRenderer to convert HTML to PDF
		Dim renderer As New ChromePdfRenderer()
		Try
			' Render HTML file as a PDF asynchronously without capturing the context.
			Dim pdf = Await renderer.RenderHtmlFileAsPdfAsync("example.html").ConfigureAwait(False)

			' Save the generated PDF asynchronously.
			Await Task.Run(Function() pdf.SaveAs("invoice.pdf")).ConfigureAwait(False)

			Return "invoice.pdf"
		Catch ex As Exception
			Console.WriteLine($"Error generating PDF: {ex.Message}")
			Return Nothing
		End Try
	End Function
End Class

この例では、作成した非同期メソッド、static async Task CreateInvoicePdfAsync()を使用して、RenderHtmlFileAsPdfAsyncメソッドで提供されたHTMLファイルからPDF請求書を生成します。 タスクの継続が不必要に元の同期コンテキストに戻るのを防ぐためにConfigureAwait(false)を使用し、非UIアプリケーションのパフォーマンスを改善しています。

また、await Task.Run()) => ...)メソッドを再び使用して、操作を非同期で実行しています。 最後に、新たに生成されたPDFファイルをpdf.SaveAsメソッドを使用して「invoice.pdf」として保存しました。 CreateInvoicePdfAsync()メソッドのすべてのコードは、予期しない例外を扱うためにtry-catchブロックでラップされています。

HTMLファイル

出力

ご覧の通り、HTMLファイルを非同期でPDFに無事変換し、きれいで高品質なPDFファイルが生成されました。