C# dilinde çok iş parçacıklı uygulamalarla çalışırken, veri bütünlüğünü korumak, özellikle IronPDF gibi bir kütüphane kullanarak anında PDF belgeleri oluştururken çok önemlidir. ConcurrentDictionary<tkey, tvalue> sınıfı, verimli anahtar ve değer çiftlerini yönetmek için iş parçacığı güvenli bir koleksiyon sağlar, hatta birden fazla iş parçacığının aynı anda ekleme, güncelleme veya arama gibi işlemler gerçekleştirdiği durumlarda bile.

Bu kılavuzda, ConcurrentDictionary'nin nasıl çalıştığını, IronPDF ile paralel PDF işleme için nasıl entegre edilebileceğini ve .NET geliştiricilerinin her alanda önemli konular olan anahtar türü, iş parçacığı güvenliği ve yaygın tuzaklar gibi mevcut bir anahtarı ele alma veya veri tutarlılığı sağlama hakkında ne bilmesi gerektiğini inceleyeceğiz.

What is a ConcurrentDictionary in C#?

ConcurrentDictionary<tkey, tvalue> sınıfı, System.Collections.Concurrent isim alanının bir parçası olan, yüksek performanslı, iş parçacığı güvenli işlemler için tasarlanmış bir genel koleksiyondur. Normal bir sözlükten farklı olarak, çoklu iş parçacıklarının koleksiyona güvenle erişmesine ve değişiklik yapmasına izin verir, tüm yapıyı kilitlemeden.

ConcurrentDictionary<string, string> yeni bir örneği şöyle görünebilir:

var dictionary = new ConcurrentDictionary<string, string>();

var dictionary = new ConcurrentDictionary<string, string>();

Dim dictionary = New ConcurrentDictionary(Of String, String)()

Dim dictionary = New ConcurrentDictionary(Of String, String)()

Özel kullanım durumunuza göre kendi TKey ve TValue türlerinizi tanımlayabilirsiniz, örneğin oluşturulmuş PDF dosya yollarını önbelleğe almak veya eşzamanlı PDF üretim görevlerini izlemek gibi.

İronPDF ile ConcurrentDictionary Kullanmanın Avantajları

IronPDF kullanarak binlerce kullanıcı için kişiselleştirilmiş faturalar üreten bir program oluşturduğunuzu hayal edin. Her iş parçacığının bir belge oluşturup sonuçlarını saklaması gerekiyorsa, normal bir sözlük, yarış koşullarını tetikleyebilir veya zaten mevcut bir anahtar olursa istisnalar fırlatabilir.

ConcurrentDictionary kullanmanın garantisini verdiği durumlar:

• İş parçacıkları arasında veri tutarlılığı
• Verimli okuma ve yazma işlemleri
• Bilinmeyen kod hatalarının önlenmesi
• Farklı anahtarlar üzerinde birden fazla iş parçacığı çalışırken sıfır kilit yükü

Yaygın Yöntemler ve İronPDF ile Kullanımları

IronPDF oluşturma senaryolarını kullanarak temel yöntemleri inceleyelim.

GetOrAdd Yöntemi: Yeni Bir Anahtar Ekle veya Mevcut Bir Anahtarı Al

Bu yöntem, belirli bir anahtarın var olup olmadığını kontrol eder. Yoksa, yeni değeri ekler.

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))

• İş parçacığı güvenliğini sağlar
• Çift oluşturmayı önler
• Belirtilen anahtar için ilişkili değeri döndürür

AddOrUpdate Yöntemi: Mevcut Bir Değeri Zarif Bir Şekilde Ele Alan

Bu yöntem, anahtar varsa değeri güncellemenizi veya yeni bir anahtar-değer çifti eklemenizi sağlar.

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))

• Mevcut anahtar için iş mantığını yönetir
• Üyelerin eşzamanlılık altında güvenli bir şekilde erişilmesini sağlar

TryAdd Yöntemi: Anahtar Yoksa Ekle

Bu yöntem bir değeri eklemeyi dener ve başarıyı belirten bir Boolean değeri döndürür.

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 If

Dim added As Boolean = pdfCache.TryAdd(userId, pdfBytes)
If Not added Then
	Console.WriteLine("PDF already cached.")
End If

• Çatışmaların önlenmesi için mükemmel
• Ekleme başarılı olursa yöntem true döner

Kullanım Durumu Tablosu: ConcurrentDictionary Yöntemleri

Performans İçin Optimize Etmek

ConcurrentDictionary, yapılandırıcı aracılığıyla ince ayar yapmayı destekler:

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)

• eşzamanlılık düzeyi: Beklenen iş parçacığı sayısı (varsayılan = varsayılan eşzamanlılık düzeyi)
• başlangıç kapasitesi: Beklenen öğe sayısı (varsayılan başlangıç kapasitesi)

Bunları düzgün bir şekilde ayarlamak, birden fazla iş parçacığı arasındaki çekişmeyi azaltır ve veri akışını artırır.

Anahtar Çatışmaları ve Varsayılanlarla İlgili Sorunları Önleme

Bir anahtar mevcut değilse, TryGetValue gibi işlemler tür için varsayılan bir değer döndürebilir:

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 If

Dim pdf As var
If Not pdfCache.TryGetValue(userId, pdf) Then
	pdf = GeneratePdfForUser(userId) ' Second call
End If

Bu, kodunuzu bilinmeyen kod veya null başvuruları karşısında korur. Bir değer olduğuna inanmadan önce her zaman belirli bir değer olup olmadığını kontrol edin.

Pratik Bir Örnek: İş Parçacığı Güvenli IronPDF Rapor Oluşturucu

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 Class

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 Class

Kaydedilmiş Dosyalar

Örnek Çıktı

Kod Çözümlemesi

ConcurrentDictionary<TKey, TValue> ile IronPDF'yi eşzamanlı kullanarak PDF'leri iş parçacığı güvenli bir şekilde oluşturmayı gösteren bu örnek. Birden fazla iş parçacığının aynı anda PDF dosyaları işlediği ve önbelleğe aldığı uygulamalar için mükemmeldir.

Neden ConcurrentDictionary?

• Anahtar-değer çiftlerine iş parçacığı güvenli erişimi sağlar.

• GetOrAdd(), çift PDF oluşturulmasını önler.

• Yüksek eşzamanlılık için manuel kilitler gerekmez. Nasıl Çalışır

• Kullanıcıların her biri bir ID ve HTML'ye sahiptir.

• Parallel.ForEach PDF oluşturmak için iş parçacıkları oluşturan paralel bir for döngüsü çalıştırır.

• Her iş parçacığı ya PDF'yi almak ya da oluşturmak için GetOrAdd() kullanır.

• PDF, kullanıcının ID'si dosya adı olarak kullanılarak kaydedilir. Özet

Bu model ideal bir kullanım sunar:

• Aynı anda birçok kullanıcı için PDF oluşturuyorsanız.
• Performans ve iş parçacığı güvenliğine ihtiyacınız varsa.
• C# dilinde temiz, güvenilir eşzamanlılık istiyorsanız.

Genişletme Yöntemleri ve Erişim Modelleri

ConcurrentDictionary, tüm LINQ özelliklerini açıklamasa da, değerleri sorgulamak için genişletme yöntemlerini kullanabilirsiniz:

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()

Bununla birlikte, sözlük değişip değişmeyeceğinden, döngü sırasında kopyalanan öğelere güvenmeyin. Gerekirse bir anlık görüntü üzerindeki .ToList() veya .ToArray() işlevlerini kullanın.

Sonuç: İş Parçacığı Güvenliği ile PDF Otomasyonu

ConcurrentDictionary<TKey, TValue>, birden fazla iş parçacığının aynı anda anahtar-değer çiftlerini okuması/yazması gereken senaryolar için idealdir—bu da onu çok iş parçacıklı uygulamalarda IronPDF için mükemmel bir arkadaş yapar.

İster işlenmiş PDF'leri önbelleğe alıyor, ister iş durumu izliyor veya gereksiz işlemleri önlüyor olun, bu iş parçacığı güvenli koleksiyonunu kullanmak, mantığınızın performans ve güvenilirlikle ölçeklenmesini sağlar.

IronPDF'yi Bugün Deneyin

Tam iş parçacığı güvenliği ile yüksek performanslı PDF uygulamaları oluşturmaya hazır mısınız? IronPDF'nin ücretsiz deneme sürümünü indirin ve C#'in ConcurrentDictionary gücü ile birleştirilmiş sorunsuz PDF oluşturma deneyimini yaşayın.