Iron Suite for .NET
10 .NETライブラリ。1つの完全なドキュメントスイート。
C# CancellationTokenをIron Softwareライブラリで使用する
現代のソフトウェア開発では、スピード、応答性、比類のないスケーラビリティが求められます。 ウェブアプリやエンタープライズソリューションの世界では、UIスレッドをブロックしたり、サーバーリソースを占有したりすることは容認できません。 これは、非同期プログラミングが、強力なC#のasyncとawaitのキーワードによって強化され、単なる機能ではなく、必須のアーキテクチャ基盤となるところです。
高パフォーマンスのライブラリを利用する開発者にとって、Iron Software Suite を用いたPDF生成、画像操作、OCR のような場合に、非同期コードを書く方法を理解することは、.NETタスク並列ライブラリのすべての力を引き出す効率的なコードを構築する鍵です。
私たちは非同期/待機 C# のメカニズムを深く探求し、このパラダイムシフトが遅い同期プログラミングをどのように高スループットの非同期操作に変えるかを探り、これらの重要な概念をIron Softwareが企業に最大のパフォーマンスを達成するためにどのように役立つかと関連付けます。
非同期プログラミングの基礎
asyncとawaitが登場する以前は、非同期操作は煩雑なコールバックや手作業によるTaskクラスの操作で管理されており、複雑でエラーが発生しやすいコードになっていました。 C# の非同期プログラミングでは、開発者が同期コードのように見えるが非同期に動作するコードを書くことを可能にすることで、これを簡素化しました。
2つのコアコンポーネント
1.asyncキーワード: async修飾子は、await式を含むことができる非同期メソッドとしてメソッドをマークします。 重要なことは、メソッドを非同期としてマークすることは、自動的にバックグラウンドのスレッドで実行することではありません。 これは、コードの継続を管理する洗練されたステートマシンをコンパイラが生成することを可能にするだけです。 非同期メソッドは通常、進行中の非同期タスクを表すためにTaskオブジェクト（TaskまたはTask）を返します。
2.awaitキーワード: awaitキーワードは魔法のコンポーネントです。 await式に遭遇したとき、メソッドは待機中のタスクが完了したかどうかをチェックします。 もしまだであれば、メソッドは実行を即座に中断し、呼び出し元のメソッド（または呼び出し元）に制御を返します。 これは、現在のスレッド（多くの場合、メインスレッドまたはスレッドプールスレッド）を解放して、他のリクエストや他のタスクを処理します。 タスクが完了すると、メソッドの残りは継続として登録され、実行するように再スケジュールされます。
以下は、基本的なコード例です：
public static async Task<string> DownloadDataAsync(string url)
{
// The async keyword allows us to use await
using var client = new HttpClient();
// await task: Control returns to the caller while the HTTP call happens
string data = await client.GetStringAsync(url); // I/O-bound
// The code after the await expression runs once the task finishes
return $"Data length: {data.Length}";
}
// Modern entry point for console apps
public static async Task Main(string[] args)
{
// This is the static async task main entry point
var result = await DownloadDataAsync("https://api.example.com/data");
Console.WriteLine(result);
}Public Shared Async Function DownloadDataAsync(url As String) As Task(Of String)
' The async keyword allows us to use await
Using client As New HttpClient()
' await task: Control returns to the caller while the HTTP call happens
Dim data As String = Await client.GetStringAsync(url) ' I/O-bound
' The code after the await expression runs once the task finishes
Return $"Data length: {data.Length}"
End Using
End Function
' Modern entry point for console apps
Public Shared Async Function Main(args As String()) As Task
' This is the static async task main entry point
Dim result As String = Await DownloadDataAsync("https://api.example.com/data")
Console.WriteLine(result)
End FunctionPublic Shared Async Function DownloadDataAsync(url As String) As Task(Of String)
' The async keyword allows us to use await
Using client As New HttpClient()
' await task: Control returns to the caller while the HTTP call happens
Dim data As String = Await client.GetStringAsync(url) ' I/O-bound
' The code after the await expression runs once the task finishes
Return $"Data length: {data.Length}"
End Using
End Function
' Modern entry point for console apps
Public Shared Async Function Main(args As String()) As Task
' This is the static async task main entry point
Dim result As String = Await DownloadDataAsync("https://api.example.com/data")
Console.WriteLine(result)
End Function静的非同期タスクmainの使用は現代の標準であり、.Wait()や.Resultのようなレガシーメソッドを使用してメインスレッドをブロックする必要性を排除します。
パフォーマンスとIronソフトウェアの統合
Taskは非同期コードの標準的な戻り値型ですが、.NET 10での高度な非同期プログラミングでは、同期的な完了が予想される"ホットパス"（例：キャッシュされた値の取得）で大幅なパフォーマンス向上を図るためにValueTaskを使用することがよくあります。 ValueTaskはメモリ割り当てを回避するため、高スループットのアプリケーションに不可欠です。
非同期操作をIronソフトウェアに適用する
Iron Software 製品は、IronOCR（光学文字認識）やIronPDF（PDF生成）のように、非同期呼び出しを活用するための完璧な候補です。 大きなHTMLドキュメントをPDFに変換するや、テキスト用に何百ページの画像をスキャンするのような操作は、しばしばCPUバウンドタスクまたはファイルシステムI/Oを伴い、非同期メソッドから大きな恩恵を受けます。
Ironソフトウェアが提供する同期および非同期メソッドを使用すると、アプリケーションの応答性が高く保たれます。
指定されたURLからドキュメントを作成するためにIronPDFを使用することを検討してください。
public static async Task GeneratePdfFromUrlAsync(string url, string outputFileName)
{
// 1. Initialize the renderer
var renderer = new IronPdf.ChromePdfRenderer();
// Optional: Set rendering options if needed (e.g., margins, headers)
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
// 2. The core asynchronous operation: Fetch and render the URL content
// This is an I/O-bound task that releases the calling thread.
var pdf = await renderer.RenderUrlAsPdfAsync(url);
// 3. Save the PDF file asynchronously
await Task.Run(() =>
{
// This is the synchronous method you confirmed exists
pdf.SaveAs(outputFileName);
});
}public static async Task GeneratePdfFromUrlAsync(string url, string outputFileName)
{
// 1. Initialize the renderer
var renderer = new IronPdf.ChromePdfRenderer();
// Optional: Set rendering options if needed (e.g., margins, headers)
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
// 2. The core asynchronous operation: Fetch and render the URL content
// This is an I/O-bound task that releases the calling thread.
var pdf = await renderer.RenderUrlAsPdfAsync(url);
// 3. Save the PDF file asynchronously
await Task.Run(() =>
{
// This is the synchronous method you confirmed exists
pdf.SaveAs(outputFileName);
});
}Imports System.Threading.Tasks
Imports IronPdf
Public Module PdfGenerator
Public Async Function GeneratePdfFromUrlAsync(url As String, outputFileName As String) As Task
' 1. Initialize the renderer
Dim renderer As New ChromePdfRenderer()
' Optional: Set rendering options if needed (e.g., margins, headers)
renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A4
' 2. The core asynchronous operation: Fetch and render the URL content
' This is an I/O-bound task that releases the calling thread.
Dim pdf = Await renderer.RenderUrlAsPdfAsync(url)
' 3. Save the PDF file asynchronously
Await Task.Run(Sub()
' This is the synchronous method you confirmed exists
pdf.SaveAs(outputFileName)
End Sub)
End Function
End ModuleImports System.Threading.Tasks
Imports IronPdf
Public Module PdfGenerator
Public Async Function GeneratePdfFromUrlAsync(url As String, outputFileName As String) As Task
' 1. Initialize the renderer
Dim renderer As New ChromePdfRenderer()
' Optional: Set rendering options if needed (e.g., margins, headers)
renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A4
' 2. The core asynchronous operation: Fetch and render the URL content
' This is an I/O-bound task that releases the calling thread.
Dim pdf = Await renderer.RenderUrlAsPdfAsync(url)
' 3. Save the PDF file asynchronously
Await Task.Run(Sub()
' This is the synchronous method you confirmed exists
pdf.SaveAs(outputFileName)
End Sub)
End Function
End Module非同期メソッドを使用して生成された PDF
RenderHtmlAsPdfAsync()の非同期メソッドを利用することで、大規模なドキュメント処理を行う際にアプリケーションがフリーズしたりブロックしたりすることを防ぎます。 これは、複雑な処理のために非同期コードを効率的に書く方法を示しています。
ベストプラクティスとエッジケース
1.複数のタスクと I/O を処理する
効率を最大化するために、リモートサーバーからのデータフェッチやデータベースクエリの実行など、独立したI/Oバウンド作業を待つときは、複数のタスクを同時に開始する必要があります。
public async Task<string[]> FetchAllDataAsync(string url1, string url2)
{
// Creating tasks starts the async operation immediately
Task<string> taskA = DownloadDataAsync(url1);
Task<string> taskB = DownloadDataAsync(url2);
// Wait for all the tasks to complete simultaneously
string[] results = await Task.WhenAll(taskA, taskB);
return results;
}public async Task<string[]> FetchAllDataAsync(string url1, string url2)
{
// Creating tasks starts the async operation immediately
Task<string> taskA = DownloadDataAsync(url1);
Task<string> taskB = DownloadDataAsync(url2);
// Wait for all the tasks to complete simultaneously
string[] results = await Task.WhenAll(taskA, taskB);
return results;
}Option Strict On
Option Infer On
Public Async Function FetchAllDataAsync(url1 As String, url2 As String) As Task(Of String())
' Creating tasks starts the async operation immediately
Dim taskA As Task(Of String) = DownloadDataAsync(url1)
Dim taskB As Task(Of String) = DownloadDataAsync(url2)
' Wait for all the tasks to complete simultaneously
Dim results As String() = Await Task.WhenAll(taskA, taskB)
Return results
End FunctionOption Strict On
Option Infer On
Public Async Function FetchAllDataAsync(url1 As String, url2 As String) As Task(Of String())
' Creating tasks starts the async operation immediately
Dim taskA As Task(Of String) = DownloadDataAsync(url1)
Dim taskB As Task(Of String) = DownloadDataAsync(url2)
' Wait for all the tasks to complete simultaneously
Dim results As String() = Await Task.WhenAll(taskA, taskB)
Return results
End Functionこれは、同時に実行されるタスクを作成するための標準的なパターンであり、ノンブロッキングの非同期操作を利用することで、アプリケーションの応答時間を劇的に高速化します。
2.同期コンテキストと ConfigureAwait(false)
待機中のタスクが完了すると、デフォルトの動作は、同期コンテキストをキャプチャし、同じスレッド（UIスレッドのような）で継続が実行されるようにします。 これはUIアプリでは重要ですが、サーバーサイドやライブラリコードでは不必要なオーバーヘッドを引き起こします。
ConfigureAwait(false)を使用することで、await呼び出し後のコードが利用可能なスレッドプールのバックグラウンドスレッドで再開できることをランタイムに伝えます。 これは、ライブラリ開発者にとって重要な慣行であり、非同期操作の最大限のパフォーマンスを保証します：
// Critical for shared libraries to avoid deadlocks and improve throughput
var data = await GetVarDataFromRemoteServer().ConfigureAwait(false);
// This code continues on any thread, improving resource usage.// Critical for shared libraries to avoid deadlocks and improve throughput
var data = await GetVarDataFromRemoteServer().ConfigureAwait(false);
// This code continues on any thread, improving resource usage.' Critical for shared libraries to avoid deadlocks and improve throughput
Dim data = Await GetVarDataFromRemoteServer().ConfigureAwait(False)
' This code continues on any thread, improving resource usage.' Critical for shared libraries to avoid deadlocks and improve throughput
Dim data = Await GetVarDataFromRemoteServer().ConfigureAwait(False)
' This code continues on any thread, improving resource usage.3. 非同期voidの危険性
非同期プログラミングにおける最も重要なルールの1つは、非同期イベントハンドラ以外では決してasync voidを使用しないことです。 例えば、ボタンをクリックするイベントハンドラメソッドは、通常、async voidを使用します：
private async void Button_Click(object sender, EventArgs e) // event handler
{
// This is one of the few places async void is acceptable
await GenerateReportAsync(html);
}private async void Button_Click(object sender, EventArgs e) // event handler
{
// This is one of the few places async void is acceptable
await GenerateReportAsync(html);
}Private Async Sub Button_Click(sender As Object, e As EventArgs) Handles Button.Click ' event handler
' This is one of the few places async void is acceptable
Await GenerateReportAsync(html)
End SubPrivate Async Sub Button_Click(sender As Object, e As EventArgs) Handles Button.Click ' event handler
' This is one of the few places async void is acceptable
Await GenerateReportAsync(html)
End Subその他の非同期 void メソッドの使用は強く推奨しません。 非同期voidメソッドは待機できないため、呼び出し元スレッドはその完了を追跡したり、例外を確実に処理することができず、エラー処理が問題になります。 他のすべての非同期メソッドには、常にTaskまたはTaskを返してください。
4.例外処理
堅牢な例外処理が不可欠です。 非同期操作が失敗すると（たとえば、ウェブサービスの呼び出しがエラーになると）、例外がタスクオブジェクトに格納されます。 タスクをawaitすると、await式は現在のスレッド（継続を再開するスレッド）に例外を投げ直すので、標準的なtry...catchブロックが例外処理に効果的に働くようになります。
結論
C#のasyncとawaitパターンは、開発者を脆い同期プログラミングから、弾力的でスケーラブルな非同期メソッドへと移行させるパラダイムシフト機能です。 基礎となる状態マシンを理解し、ベストプラクティスに従うことで - 例えば、async voidよりTaskを優先し、ライブラリではConfigureAwait(false)を使用し、例外処理を正しく実装することなど - 開発者は、Iron SoftwareのSuiteのような複雑な処理タスクを優れたパフォーマンスで処理するアプリケーションを作成できます。
ソフトウェアは、高性能な非同期プログラミングを中核とした製品の開発に取り組んでおり、コードの記述方法によって最大限のスループットが得られるようにしています。 Iron Softwareの世界を探求し、非同期タスク処理を活用することで、アプリケーションの速度と応答性を劇的に改善できるかを確認してください。
オフィス文書向けの.NET API製品10個