C# Concurrentdictionary(開発者向けの仕組み)
C#でマルチスレッドアプリケーションを扱う場合、データの整合性を維持することが重要です。特にIronPDFのようなライブラリを使用して動的にPDFドキュメントを生成する場合には特にそうです。 ConcurrentDictionary<tkey, tvalue> クラスはスレッドセーフなコレクションを提供し、複数のスレッドが同時に挿入や更新、検索といった操作を行う際にも効率的にキーと値のペアを管理できます。
このガイドでは、ConcurrentDictionaryの動作、IronPDFとの並列PDF処理の統合方法、.NET開発者が知っておくべきキーの種類、スレッドセーフティ、および既存のキーの処理やデータ整合性の確保といった一般的な落とし穴について探ります。
What is a ConcurrentDictionary in C#?
ConcurrentDictionary<tkey, tvalue>クラスは、System.Collections.Concurrent名前空間の一部であり、高性能かつスレッドセーフな操作のために設計されたジェネリックコレクションです。 通常の辞書とは異なり、複数のスレッドがコレクションに安全にアクセスし変更を加えることができます。
ConcurrentDictionary<string, string>の新しいインスタンスはこのように見えるかもしれません:
var dictionary = new ConcurrentDictionary<string, string>();Dim dictionary = New ConcurrentDictionary(Of String, String)()Dim dictionary = New ConcurrentDictionary(Of String, String)()特定のユースケースに基づいて独自のTKeyとTValue型を定義できます。たとえば、PDFファイルのパスをキャッシュする場合や、並列のPDF生成タスクを追跡する場合です。
IronPDFでConcurrentDictionaryを使用する理由
IronPDFを使用して何千人ものユーザー用の個別化された請求書を生成するプログラムを構築していると想像してみてください。 各スレッドがドキュメントをレンダリングし、その結果を保存する必要がある場合、通常の辞書は競合状態を引き起こし、キーがすでに存在する場合には例外をスローする危険があります。
ConcurrentDictionaryを使用することにより以下を確保できます:
- スレッド間のデータ整合性
- 効率的な読み取りと書き込み
- 不明なコードエラーの防止
- 複数のスレッドが異なるキーで操作する際のロックオーバーヘッドのゼロ
IronPDFと共に使う一般的な方法
IronPDFのレンダリングシナリオを用いて主要なメソッドを分解してみましょう。
GetOrAddメソッド: 新しいキーを取得または追加
このメソッドは指定されたキーが存在するかどうかをチェックします。 存在しない場合は、新しい値を追加します。
var filePath = pdfCache.GetOrAdd(userId, id => GeneratePdfForUser(id));var filePath = pdfCache.GetOrAdd(userId, id => GeneratePdfForUser(id));Dim filePath = pdfCache.GetOrAdd(userId, Function(id) GeneratePdfForUser(id))Dim filePath = pdfCache.GetOrAdd(userId, Function(id) GeneratePdfForUser(id))- スレッドセーフティを保証
- 重複したレンダリングを避ける
- 指定されたキーに対する関連する値を返す
AddOrUpdateメソッド: 既存の値を上手に扱う
このメソッドは、キーが存在する場合は値を更新し、新しいキーと値のペアを追加することができます。
pdfCache.AddOrUpdate(userId,
id => GeneratePdfForUser(id),
(id, existingValue) => UpdatePdfForUser(id, existingValue));pdfCache.AddOrUpdate(userId,
id => GeneratePdfForUser(id),
(id, existingValue) => UpdatePdfForUser(id, existingValue));pdfCache.AddOrUpdate(userId, Function(id) GeneratePdfForUser(id), Function(id, existingValue) UpdatePdfForUser(id, existingValue))pdfCache.AddOrUpdate(userId, Function(id) GeneratePdfForUser(id), Function(id, existingValue) UpdatePdfForUser(id, existingValue))- 既存のキーに対するロジックを管理
- 同時処理下でもアクセスされるメンバーのセーフティを保証
TryAddメソッド: キーが存在しない場合に追加
このメソッドは値を追加し、成功を示すブール値を返します。
bool added = pdfCache.TryAdd(userId, pdfBytes);
if (!added)
{
Console.WriteLine("PDF already cached.");
}bool added = pdfCache.TryAdd(userId, pdfBytes);
if (!added)
{
Console.WriteLine("PDF already cached.");
}Dim added As Boolean = pdfCache.TryAdd(userId, pdfBytes)
If Not added Then
Console.WriteLine("PDF already cached.")
End IfDim added As Boolean = pdfCache.TryAdd(userId, pdfBytes)
If Not added Then
Console.WriteLine("PDF already cached.")
End If- 競合を避けるのにぴったり
- 挿入が成功した場合はtrueを返す
Use Case Table: ConcurrentDictionary Methods

パフォーマンス向上の最適化
ConcurrentDictionaryはコンストラクタを通じてチューニングをサポートします:
int concurrencyLevel = 4;
int initialCapacity = 100;
var dictionary = new ConcurrentDictionary<string, byte[]>(concurrencyLevel, initialCapacity);int concurrencyLevel = 4;
int initialCapacity = 100;
var dictionary = new ConcurrentDictionary<string, byte[]>(concurrencyLevel, initialCapacity);Dim concurrencyLevel As Integer = 4
Dim initialCapacity As Integer = 100
Dim dictionary = New ConcurrentDictionary(Of String, Byte())(concurrencyLevel, initialCapacity)Dim concurrencyLevel As Integer = 4
Dim initialCapacity As Integer = 100
Dim dictionary = New ConcurrentDictionary(Of String, Byte())(concurrencyLevel, initialCapacity)- concurrencyLevel: 予想されるスレッド数(デフォルト = デフォルトの並列レベル)
- initialCapacity: 予想される要素数(デフォルトの初期容量)
これらを適切に設定することでスループットを改善し、複数のスレッド間での競合を減少させます。
キーの競合とデフォルトによる問題の防止
キーが存在しない場合、TryGetValueのような操作はその型のデフォルト値を返すことがあります:
if (!pdfCache.TryGetValue(userId, out var pdf))
{
pdf = GeneratePdfForUser(userId); // Second call
}if (!pdfCache.TryGetValue(userId, out var pdf))
{
pdf = GeneratePdfForUser(userId); // Second call
}Dim pdf As var
If Not pdfCache.TryGetValue(userId, pdf) Then
pdf = GeneratePdfForUser(userId) ' Second call
End IfDim pdf As var
If Not pdfCache.TryGetValue(userId, pdf) Then
pdf = GeneratePdfForUser(userId) ' Second call
End Ifこれにより、不明なコードやヌル参照からコードを保護します。 特定の値を仮定する前には必ずチェックしてください。
実用的な例: スレッドセーフなIronPDFレポートジェネレータ
using System;
using System.Collections.Concurrent;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;
using IronPdf;
public class Program
{
static ConcurrentDictionary<string, byte[]> pdfReports =
new ConcurrentDictionary<string, byte[]>();
static void Main(string[] args)
{
// Simulated user list with HTML content
var users = new List<User>
{
new User { Id = "user1", HtmlContent = "<h1>Report for User 1</h1>" },
new User { Id = "user2", HtmlContent = "<h1>Report for User 2</h1>" },
new User { Id = "user3", HtmlContent = "<h1>Report for User 3</h1>" }
};
// Generate PDFs concurrently
var renderer = new ChromePdfRenderer();
Parallel.ForEach(users, user =>
{
var pdf = pdfReports.GetOrAdd(user.Id, id =>
{
var pdfDoc = renderer.RenderHtmlAsPdf(user.HtmlContent);
return pdfDoc.BinaryData;
});
SaveToFile(pdf, $"{user.Id}.pdf");
});
Console.WriteLine("PDF generation complete.");
}
// Utility method to write PDF binary data to file
static void SaveToFile(byte[] pdfBytes, string filePath)
{
File.WriteAllBytes(filePath, pdfBytes);
Console.WriteLine($"Saved: {filePath}");
}
}
// Simple user class with ID and HTML content
public class User
{
public string Id { get; set; }
public string HtmlContent { get; set; }
}using System;
using System.Collections.Concurrent;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;
using IronPdf;
public class Program
{
static ConcurrentDictionary<string, byte[]> pdfReports =
new ConcurrentDictionary<string, byte[]>();
static void Main(string[] args)
{
// Simulated user list with HTML content
var users = new List<User>
{
new User { Id = "user1", HtmlContent = "<h1>Report for User 1</h1>" },
new User { Id = "user2", HtmlContent = "<h1>Report for User 2</h1>" },
new User { Id = "user3", HtmlContent = "<h1>Report for User 3</h1>" }
};
// Generate PDFs concurrently
var renderer = new ChromePdfRenderer();
Parallel.ForEach(users, user =>
{
var pdf = pdfReports.GetOrAdd(user.Id, id =>
{
var pdfDoc = renderer.RenderHtmlAsPdf(user.HtmlContent);
return pdfDoc.BinaryData;
});
SaveToFile(pdf, $"{user.Id}.pdf");
});
Console.WriteLine("PDF generation complete.");
}
// Utility method to write PDF binary data to file
static void SaveToFile(byte[] pdfBytes, string filePath)
{
File.WriteAllBytes(filePath, pdfBytes);
Console.WriteLine($"Saved: {filePath}");
}
}
// Simple user class with ID and HTML content
public class User
{
public string Id { get; set; }
public string HtmlContent { get; set; }
}Imports System
Imports System.Collections.Concurrent
Imports System.Collections.Generic
Imports System.IO
Imports System.Threading.Tasks
Imports IronPdf
Public Class Program
Private Shared pdfReports As New ConcurrentDictionary(Of String, Byte())()
Shared Sub Main(ByVal args() As String)
' Simulated user list with HTML content
Dim users = New List(Of User) From {
New User With {
.Id = "user1",
.HtmlContent = "<h1>Report for User 1</h1>"
},
New User With {
.Id = "user2",
.HtmlContent = "<h1>Report for User 2</h1>"
},
New User With {
.Id = "user3",
.HtmlContent = "<h1>Report for User 3</h1>"
}
}
' Generate PDFs concurrently
Dim renderer = New ChromePdfRenderer()
Parallel.ForEach(users, Sub(user)
Dim pdf = pdfReports.GetOrAdd(user.Id, Function(id)
Dim pdfDoc = renderer.RenderHtmlAsPdf(user.HtmlContent)
Return pdfDoc.BinaryData
End Function)
SaveToFile(pdf, $"{user.Id}.pdf")
End Sub)
Console.WriteLine("PDF generation complete.")
End Sub
' Utility method to write PDF binary data to file
Private Shared Sub SaveToFile(ByVal pdfBytes() As Byte, ByVal filePath As String)
File.WriteAllBytes(filePath, pdfBytes)
Console.WriteLine($"Saved: {filePath}")
End Sub
End Class
' Simple user class with ID and HTML content
Public Class User
Public Property Id() As String
Public Property HtmlContent() As String
End ClassImports System
Imports System.Collections.Concurrent
Imports System.Collections.Generic
Imports System.IO
Imports System.Threading.Tasks
Imports IronPdf
Public Class Program
Private Shared pdfReports As New ConcurrentDictionary(Of String, Byte())()
Shared Sub Main(ByVal args() As String)
' Simulated user list with HTML content
Dim users = New List(Of User) From {
New User With {
.Id = "user1",
.HtmlContent = "<h1>Report for User 1</h1>"
},
New User With {
.Id = "user2",
.HtmlContent = "<h1>Report for User 2</h1>"
},
New User With {
.Id = "user3",
.HtmlContent = "<h1>Report for User 3</h1>"
}
}
' Generate PDFs concurrently
Dim renderer = New ChromePdfRenderer()
Parallel.ForEach(users, Sub(user)
Dim pdf = pdfReports.GetOrAdd(user.Id, Function(id)
Dim pdfDoc = renderer.RenderHtmlAsPdf(user.HtmlContent)
Return pdfDoc.BinaryData
End Function)
SaveToFile(pdf, $"{user.Id}.pdf")
End Sub)
Console.WriteLine("PDF generation complete.")
End Sub
' Utility method to write PDF binary data to file
Private Shared Sub SaveToFile(ByVal pdfBytes() As Byte, ByVal filePath As String)
File.WriteAllBytes(filePath, pdfBytes)
Console.WriteLine($"Saved: {filePath}")
End Sub
End Class
' Simple user class with ID and HTML content
Public Class User
Public Property Id() As String
Public Property HtmlContent() As String
End Class保存されたファイル

例の出力

コードの内訳
この例は、ConcurrentDictionary<TKey, TValue>をIronPDFと組み合わせてスレッドセーフな方法でPDFを生成する方法を示します。 これは、複数のスレッドが同時にPDFファイルを処理およびキャッシュするアプリに最適です。
ConcurrentDictionaryを使用する理由
-
キーバリューペアへのスレッドセーフなアクセスを保証します。
-
GetOrAdd()は重複したPDF生成を避けます。 -
手動ロックは不要であり、高い同時実行性に最適です。 動作方法
-
各ユーザーのリストには、IDとHTMLがあります。
-
Parallel.ForEachはスレッドを生成してPDFを作成します。
-
各スレッドは
GetOrAdd()を使用してPDFを取得または作成します。 -
PDFはユーザーのIDをファイル名として使用して保存されます。 まとめ
このパターンが理想的なのは:
- 多くのユーザーのために一度にPDFを生成している。
- パフォーマンスおよびスレッドセーフティが必要です。
- C#でのクリーンで信頼性のある競合動作が必要です。
拡張メソッドとアクセスパターン
ConcurrentDictionaryはすべてのLINQ機能を公開していませんが、拡張メソッドを使用して値をクエリすることができます:
var completedKeys = pdfReports.Keys.Where(k => k.StartsWith("done-")).ToList();var completedKeys = pdfReports.Keys.Where(k => k.StartsWith("done-")).ToList();Dim completedKeys = pdfReports.Keys.Where(Function(k) k.StartsWith("done-")).ToList()Dim completedKeys = pdfReports.Keys.Where(Function(k) k.StartsWith("done-")).ToList()ただし、辞書が変更する可能性があるため、反復中にコピーされた要素に依存するのは避けてください。 必要に応じて、.ToList()または.ToArray()を使用してスナップショットで作業します。
結論: スレッドセーフティがPDF自動化と出会う
ConcurrentDictionary<TKey, TValue> は、複数のスレッドが同時にキーと値のペアを読み書きする必要があるシナリオに最適です。これにより、マルチスレッドアプリケーションでIronPDFに最適なパートナーとなります。
キャッシュされたPDFのレンダリング、ジョブステータスの追跡、重複操作の防止など、スレッドセーフなコレクションを使用すると、パフォーマンスと信頼性を備えたロジックが拡張することを保証できます。
IronPDFを今日試してみましょう
完全なスレッドセーフティを備えた高性能のPDFアプリケーションを作成する準備はできていますか? 無料トライアルをダウンロードしてIronPDFとC#のConcurrentDictionaryの力を組み合わせたシームレスなPDF生成を体験してください。
ジェイコブ・メラーはIron Softwareの最高技術責任者(CTO)であり、C# PDFテクノロジーを開拓する先見的なエンジニアです。Iron Softwareのコアコードベースを支えるオリジナル開発者として、彼は創業以来、会社の製品アーキテクチャを形成し、CEOのCameron Rimingtonとともに、会社をNASA、Tesla、および世界的な政府機関にサービスを提供する50人以上の会社に変えました。1999年にロンドンで最初のソフトウェアビジネスを開業し、2005年に最初 for .NETコンポーネントを作成した後、Microsoftのエコシステム全体で複雑な問題を解決することを専門としました。