Async/Await Nedir?

Async ve await anahtar kelimeleri, C#'ta asenkron yöntemler tanımlamak için kullanılır. Asenkron bir yöntem, uygulamanın ana iş parçacığının yürütülmesini bloke etmeden bir işlem gerçekleştirir, böylece uygulama uzun süren görevleri yaparken bile yanıt verebilir durumda kalır.

• async: Bu anahtar kelime, asenkron işlemler gerçekleştirmeleri beklenen yöntemlere uygulanır. Yöntemin en az bir await ifadesi içerdiğini belirtir.
• await: Bu anahtar kelime, beklenen görev tamamlanana kadar yöntemin yürütülmesini duraklatmak için kullanılır. İşlem bitene kadar iş parçacığının diğer görevleri yerine getirmesi sağlanır.

public async Task WaitExampleAsync()
{
    await Task.Delay(1000); // Waits for 1 second without blocking the thread
    Console.WriteLine("Finished waiting asynchronously!");
}

public async Task WaitExampleAsync()
{
    await Task.Delay(1000); // Waits for 1 second without blocking the thread
    Console.WriteLine("Finished waiting asynchronously!");
}

Public Async Function WaitExampleAsync() As Task
	Await Task.Delay(1000) ' Waits for 1 second without blocking the thread
	Console.WriteLine("Finished waiting asynchronously!")
End Function

Async yöntemleri, ana iş parçacığını görevlerin tamamlanmasını beklerken diğer işlemleri yerine getirmesi için serbest bırakarak yanıt verebilirliği artırır.

Async Programlamanın Temel Faydaları

• Engellemesiz işlemler: Async programlama ile, dosya I/O veya ağ istekleri gibi zaman alıcı işlemler, ana iş parçacığını bloke etmez. Bu, web uygulamaları için çok önemlidir, çünkü engellemesiz işlemler sunucunun birden çok isteği aynı anda işlemesini sağlar.
• Geliştirilmiş ölçeklenebilirlik: Async anahtar kelimesi, uygulamanın daha az iş parçacığı ile daha fazla eşzamanlı işlemi yönetmesini sağlar, bu da ölçeklenebilirliği artırır.
• Daha iyi kullanıcı deneyimi: Masaüstü veya web uygulamaları için, async işlemler, kullanıcı girdisine yanıt verebilir durumda kalmayı sağlar.

IronPDF Genel Bakış

IronPDF, .NET geliştiricilerinin PDF işlevselliğini doğrudan uygulamalarına entegre etmelerine olanak tanır, ister web veya masaüstü ortamları olsun. IronPDF'un sunduğu bazı anahtar özellikler şunlardır:

• HTML'den PDF'ye Dönüştürme: IronPDF, HTML içeriğini (CSS, görüntüler ve JavaScript dahil) tamamen biçimlendirilmiş PDF'lere dönüştürebilir. Dinamik web sayfalarını veya raporları PDF olarak render etmek için özellikle kullanışlıdır.
• PDF Düzenleme: IronPDF ile var olan PDF belgelerini metin, görüntü ve grafik ekleyerek manipüle edebilir, mevcut sayfaların içeriğini düzenleyebilirsiniz.
• Metin ve Görüntü Çıkarımı: Kütüphane, PDF'lerden metin ve görüntü çıkarmanıza olanak tanır ve PDF içeriğini ayrıştırmayı kolaylaştırır.
• Form Doldurma: IronPDF, PDF'lerdeki form alanlarını doldurmayı destekler ve özelleştirilmiş belgeler oluşturmak için kullanışlı olur.
• Filigran Eklemek: Marka veya telif hakkı koruması için PDF belgelere filigranlar eklemek de mümkündür.

IronPDF'ü Async/Await ile Kullanma Neden?

Her ne kadar IronPDF yerel olarak asenkron olmasa da, çoğu PDF işleme görevinin I/O odaklı doğası nedeniyle async/await desenine oldukça uygundur. Örneğin, HTML'yi PDF'ye dönüştürmek veya büyük bir PDF belgesi yüklemek önemli miktarda zaman alabilir, fakat bu işlemler asenkron olarak gerçekleştirilebilir ve ana iş parçacığının bloke olmasını önler.

IronPDF'ün async programlamaya iyi oturduğu birkaç örnek:

• PDF Oluşturma: Uygulamanızın dinamik içeriklere dayalı birden fazla PDF dosyası oluşturması gerekiyorsa, bu işlemleri asenkron olarak çalıştırmak, sistemin PDF'ler oluşturulurken yanıt verebilir durumda kalmasını sağlar.
• PDF Manipülasyonu: Büyük PDF dosyalarını manipüle etmeniz gerekiyorsa, örneğin, filigranlar eklemek veya belgeleri birleştirmek gibi, bu görevlerin asenkron olarak gerçekleştirilmesi, kaynak tüketen bu işlemler arka planda işlenirken uygulamanızın donmasını engeller.
• Dosya I/O: PDF'lerden okuma ve yazma I/O odaklı bir işlemdir. Bu görevler için asenkron programlama mükemmel bir seçimdir çünkü sistem kaynaklarını serbest bırakır ve gereksiz blokajları önler.

Temel Örnek: IronPDF ile Asenkron PDF Oluşturma

IronPDF kullanarak bir PDF dosyası oluşturmak için asenkron kod yazmanın örneği:

using IronPdf;

public class Program
{
    public static async Task Main(string[] args)
    {
        // Initialize renderer
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Use Task.Run to run the PDF generation asynchronously
        PdfDocument pdf = await Task.Run(() => renderer.RenderHtmlAsPdf("<h1>Async PDF Example</h1>"));

        // Save the generated PDF to a file
        await Task.Run(() => pdf.SaveAs("output.pdf"));
    }
}

using IronPdf;

public class Program
{
    public static async Task Main(string[] args)
    {
        // Initialize renderer
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Use Task.Run to run the PDF generation asynchronously
        PdfDocument pdf = await Task.Run(() => renderer.RenderHtmlAsPdf("<h1>Async PDF Example</h1>"));

        // Save the generated PDF to a file
        await Task.Run(() => pdf.SaveAs("output.pdf"));
    }
}

Imports IronPdf

Public Class Program
	Public Shared Async Function Main(ByVal args() As String) As Task
		' Initialize renderer
		Dim renderer As New ChromePdfRenderer()

		' Use Task.Run to run the PDF generation asynchronously
		Dim pdf As PdfDocument = Await Task.Run(Function() renderer.RenderHtmlAsPdf("<h1>Async PDF Example</h1>"))

		' Save the generated PDF to a file
		Await Task.Run(Function() pdf.SaveAs("output.pdf"))
	End Function
End Class

Bu Nasıl Çalışır

1. HTML'den PDF'ye Dönüştürücü Oluşturma: ChromePdfRenderer sınıfı, HTML içeriğini PDF'ye dönüştürmek için kullanılır. In this example, we pass simple HTML content as a string ("

   Async PDF Example

   "), but in a real application, this could be dynamic HTML, such as a report template.

2. Async PDF Oluşturma için Task.Run Kullanma: RenderHtmlAsPdf metodu varsayılan olarak asenkron değildir, bu yüzden PDF üretimini bir arka plan kopyasına yüklemek için Task.Run() kullanırız. Bu, özellikle büyük veya karmaşık belgelerle ilgilenirken, PDF oluşturmanın kaynak tüketen ve zaman alıcı olabileceği için önemlidir.

3. PDF Kaydetme: PDF üretildikten sonra, dosya sistemine pdf.SaveAs() kullanılarak kaydedilir. Bu G/Ç işlemi, dosyayı kaydederken ana iş parçacığını engellemediğinden emin olmak için Task.Run() içinde de sarılır.

4. İşlemleri Beklemek: await anahtar kelimesi, her asenkron işlemin bir sonraki başlamadan önce tamamlanmasını sağlar. PDF oluşturmayı tamamlamak için beklerken, ana iş parçacığı diğer işleri (örn. web uygulamasındaki diğer HTTP isteklerini sunarken) yerine getirebilmesi için serbest bırakılır.

IronPDF ile Birden Çok Görevi Yönetme

Büyük PDF'ler ile çalışan uygulamalar için, büyük dosyaları bölmek, birleştirmek veya içerik eklemek gibi birden fazla işlem yapmanız gerekebilir. Async kullanmak, bir işlem işlenirken uygulamanın kullanıcı girdilerine veya isteklere yanıt verebilir duruma gelmesini sağladığı için önemlidir.

Örneğin, birden fazla asenkron operasyonu boru hattı gibi birleştirebilirsiniz:

using IronPdf;

public class Program
{
    public static async Task Main(string[] args)
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        PdfDocument page = renderer.RenderHtmlAsPdf("<h1>Added Page</h1>");

        // Use Task.Run to run the PDF generation asynchronously
        PdfDocument pdf = await Task.Run(() => PdfDocument.FromFile("output.pdf"));

        // Perform some operations asynchronously
        await Task.Run(() => pdf.ApplyWatermark("Confidential"));

        PdfDocument merged = await Task.Run(() => PdfDocument.Merge(pdf, page));
        await Task.Run(() => merged.SaveAs("processed_output.pdf"));
    }
}

using IronPdf;

public class Program
{
    public static async Task Main(string[] args)
    {
        ChromePdfRenderer renderer = new ChromePdfRenderer();
        PdfDocument page = renderer.RenderHtmlAsPdf("<h1>Added Page</h1>");

        // Use Task.Run to run the PDF generation asynchronously
        PdfDocument pdf = await Task.Run(() => PdfDocument.FromFile("output.pdf"));

        // Perform some operations asynchronously
        await Task.Run(() => pdf.ApplyWatermark("Confidential"));

        PdfDocument merged = await Task.Run(() => PdfDocument.Merge(pdf, page));
        await Task.Run(() => merged.SaveAs("processed_output.pdf"));
    }
}

Imports IronPdf

Public Class Program
	Public Shared Async Function Main(ByVal args() As String) As Task
		Dim renderer As New ChromePdfRenderer()
		Dim page As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Added Page</h1>")

		' Use Task.Run to run the PDF generation asynchronously
		Dim pdf As PdfDocument = Await Task.Run(Function() PdfDocument.FromFile("output.pdf"))

		' Perform some operations asynchronously
		Await Task.Run(Function() pdf.ApplyWatermark("Confidential"))

		Dim merged As PdfDocument = Await Task.Run(Function() PdfDocument.Merge(pdf, page))
		Await Task.Run(Function() merged.SaveAs("processed_output.pdf"))
	End Function
End Class

Bu örnekte, bir PDF dosyası yükleyip yenisini oluştururuz, bir filigran ekler, iki PDF'yi birleştirir ve hepsini ana iş parçacığını bloke etmeden kaydederiz.

IronPDF ile Asenkron Operasyonlar için En İyi Uygulamalar

• İş Parçacığı Havuzu Düşünceleri: IronPDF, işleme için arka plan iş parçacıklarına dayandığından, Task.Run() kullanırken iş parçacığı havuzuna dikkat edin. Sık frekanslı görevler için, iş parçacığı havuzunu aşırı yüklememek adına özel bir arka plan servisi veya iş kuyrukları kullanmayı düşünün.
• Asenkron void metotlardan kaçının: Asenkron işlemler gerçekleştiren metotlar için her zaman async Task kullanın. Asenkron void yöntemlerini sadece olay işleyiciler için saklayın.
• İptal İşaretçileri: PDF oluşturma veya metin çıkarma gibi uzun süre çalışan işlemler için kullanıcıların işlemi gerekirse iptal etmelerine olanak tanıyan iptal işaretçilerini desteklemek iyi bir fikirdir. Bu, işlem artık gerekli değilse kaynakların serbest bırakılmasını sağlar.

public async Task GeneratePdfWithCancellationAsync(CancellationToken cancellationToken)
{
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    var pdf = await Task.Run(() => renderer.RenderHtmlAsPdf("<h1>Async PDF with Cancellation</h1>"), cancellationToken);

    if (cancellationToken.IsCancellationRequested)
    {
        Console.WriteLine("Operation was canceled.");
        return;
    }
    pdf.SaveAs("output.pdf");
}

public async Task GeneratePdfWithCancellationAsync(CancellationToken cancellationToken)
{
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    var pdf = await Task.Run(() => renderer.RenderHtmlAsPdf("<h1>Async PDF with Cancellation</h1>"), cancellationToken);

    if (cancellationToken.IsCancellationRequested)
    {
        Console.WriteLine("Operation was canceled.");
        return;
    }
    pdf.SaveAs("output.pdf");
}

Public Async Function GeneratePdfWithCancellationAsync(ByVal cancellationToken As CancellationToken) As Task
	Dim renderer As New ChromePdfRenderer()
	Dim pdf = Await Task.Run(Function() renderer.RenderHtmlAsPdf("<h1>Async PDF with Cancellation</h1>"), cancellationToken)

	If cancellationToken.IsCancellationRequested Then
		Console.WriteLine("Operation was canceled.")
		Return
	End If
	pdf.SaveAs("output.pdf")
End Function

• Hata Yönetimi: Herhangi bir async operasyonunda olduğu gibi, PDF işleme sırasında meydana gelebilecek dosya erişim sorunları veya geçersiz girdi verileri gibi istisnalar için uygun hata yönetimini sağladığınızdan emin olun.

try
{
    var pdf = await Task.Run(() => renderer.RenderHtmlAsPdf("<h1>Async PDF</h1>"));
    pdf.SaveAs("output.pdf");
}
catch (Exception ex)
{
    Console.WriteLine($"Error: {ex.Message}");
}

try
{
    var pdf = await Task.Run(() => renderer.RenderHtmlAsPdf("<h1>Async PDF</h1>"));
    pdf.SaveAs("output.pdf");
}
catch (Exception ex)
{
    Console.WriteLine($"Error: {ex.Message}");
}

Try
	Dim pdf = Await Task.Run(Function() renderer.RenderHtmlAsPdf("<h1>Async PDF</h1>"))
	pdf.SaveAs("output.pdf")
Catch ex As Exception
	Console.WriteLine($"Error: {ex.Message}")
End Try