Async/Await Nedir?

Async ve await anahtar kelimeleri, C#'da asenkron yöntemler tanımlamak için kullanılır. Bir asenkron yöntem, uygulamanın ana iş parçacığının yürütülmesini engellemeden bir işlem gerçekleştirir ve uygulamanın uzun süreli görevler gerçekleştirirken yanıt verir durumda kalmasını sağlar.

• async: Bu anahtar kelime, asenkron işlemler gerçekleştirmesi beklenen yöntemlere uygulanır. Yöntemin en az bir await ifadesi içerdiğini belirtir.
• await: Bu anahtar kelime, beklenen görevin tamamlanmasına 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 yürütmek için serbest olduğundan emin olur.

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 metodlar, ana iş parçacığını diğer işlemleri yönetmek için serbest bırakarak, görevlerin tamamlanmasını beklerken yanıt verme yeteneğini artırır.

Async Programlamanın Temel Faydaları

• Bloke etmeyen işlemler: Async programlama ile zaman alan işlemler (örneğin dosya I/O veya ağ istekleri) ana iş parçacığını engellemez. Bu, sunucunun çoklu istekleri aynı anda işleyebilmesini sağlamak için web uygulamaları için kritik önem taşır.
• Gelişmiş ölçeklenebilirlik: Async anahtar kelimesi, uygulamanın daha az iş parçacığı ile daha fazla eş zamanlı işlem yapmasını sağlar, bu da ölçeklenebilirliği artırır.
• Daha iyi kullanıcı deneyimi: Masaüstü veya web uygulamaları için, arka planda görevler çalışırken async işlemler UI'nin kullanıcı girişlerine yanıt vermesini sağlar.

IronPDF Genel Bakış

IronPDF, .NET geliştiricilerinin PDF işlevselliğini hem web hem de masaüstü ortamlar için doğrudan uygulamalarına entegre etmelerini sağlar. IronPDF'un sunduğu bazı temel özellikler şunlardır:

• HTML'den PDF'e Dönüşüm: IronPDF, HTML içeriğini (CSS, resimler ve JavaScript dahil) tamamen biçimlendirilmiş PDF'lere dönüştürebilir. Bu, dinamik web sayfalarını veya raporları PDF olarak sunmak için özellikle yararlıdır.
• PDF Düzenleme: IronPDF ile mevcut PDF belgelerini metin, resim ve grafik ekleyerek manipüle edebilir ve mevcut sayfaların içeriğini düzenleyebilirsiniz.
• Metin ve Resim Çıkartma: Kütüphane, PDF'lerden metin ve resim çıkarmaya olanak tanır, böylece PDF içeriğini kolayca ayrıştırabilir ve analiz edebilirsiniz.
• Form Doldurma: IronPDF, PDF'lerdeki form alanlarını doldurmayı destekler, bu, özelleştirilmiş belgeler oluşturmak için yararlıdır.
• Filigran Eklemek: PDF belgelerine markalama veya telif hakkı koruması için filigranlar eklemek de mümkündür.

Neden Async/Await ile IronPDF Kullanmalısınız?

IronPDF doğrudan asenkron olmasa da, çoğu PDF işleme görevinin I/O ağırlıklı doğası nedeniyle async/await düzenleri için uygundur. Örneğin, HTML'yi PDF'e dönüştürmek veya büyük bir PDF belgesini yüklemek önemli miktarda zaman alabilir, ancak bu işlemler asenkron olarak yapılabilir, böylece ana iş parçacığı bloke edilmez.

IronPDF'un async programlamaya nasıl iyi uyduğuna dair birkaç örnek:

• PDF Oluşturma: Eğer uygulamanız dinamik içeriğe dayanan çoklu PDF'ler oluşturmanız gerekiyorsa, bu işlemleri asenkron olarak gerçekleştirmek, PDF'ler oluşturulurken sistemin yanıt vermesini sağlar.
• PDF Manipülasyonu: Büyük PDF'leri örneğin filigran eklemek veya belgeleri birleştirmek gibi işlemler yapmanız gerekeceği durumda, bu görevleri asenkron olarak yapmak, uygulamanızın bu zaman gerektiren işlemler arka planda işlenirken donmamasını sağlar.
• Dosya I/O: PDF'lerden okuma ve yazma I/O ağırlıklı bir işlemdir. Async programlama, sistem kaynaklarını serbest bırakır ve gereksiz engellemelerden kaçınarak bu görevler için mükemmeldir.

Temel Örnek: IronPDF ile Asenkron PDF Oluşturma

IronPDF kullanarak bir PDF dosyası oluşturmak için asenkron kod yazmanın bir ö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'yi PDF Dönüştürücüye Çevirme: ChromePdfRenderer sınıfı, HTML içeriğini PDF'e 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. Asenkron PDF Oluşturma için Task.Run Kullanma: RenderHtmlAsPdf metodu varsayılan olarak async değildir, bu yüzden PDF oluşturmayı arka plan iş parçacığına devretmek için Task.Run() kullanıyoruz. Bu önemlidir çünkü PDF oluşturma özellikle büyük veya karmaşık belgelerle uğraşılırken kaynak yoğun ve zaman alıcı olabilir.

3. PDF'yi Kaydetme: PDF oluşturulduktan sonra, pdf.SaveAs() kullanılarak dosya sistemine kaydedilir. Bu G/Ç işlemi de, dosyayı kaydederken ana iş parçacığını engellememesini sağlamak için Task.Run() içinde sarılmıştır.

4. Bekleme İşlemleri: await anahtar kelimesi, her bir asenkron işlemin bir sonrakine başlamadan önce tamamlanmasını garanti eder. PDF oluşturma tamamlanmasını beklerken, ana iş parçacığı diğer görevleri (örneğin, bir web uygulamasında diğer HTTP isteklerini işlemeyi) yönetmek için serbest kalır.

IronPDF ile Birden Çok Görev Yönetimi

Büyük PDF'lerle uğraşan uygulamalar için, büyük dosyalara içerik ekleme, bölme ve birleştirme gibi birden çok işlem yapmanız gerekebilir. Bir işlem işlenirken uygulamanın kullanıcı girişlerine veya isteklere yanıt vermesini sağlamak için async kullanmak önemlidir.

Örneğin, birden fazla asenkron işlemi bir pipeline'da 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üklenir ve yenisi oluşturulur, bir filigran eklenir, iki PDF birleştirilir ve ana iş parçacığını engellemeden kaydedilir.

IronPDF ile Async İşlemler için En İyi Uygulamalar

• İş Parçacığı Havuzu Dikkate Alınması Gerekenler: IronPDF, işlemler için arka plan iş parçacıklarına dayandığından, Task.Run() kullanırken iş parçacığı havuzuna dikkat edin. Yüksek frekanslı görevler için, iş parçacığı havuzunu aşırı yüklenmekten kaçınmak için özel bir arka plan hizmeti veya sıraya alma görevlerini kullanmayı düşünün.
• async void metodlarından kaçının: Asenkron işlemler gerçekleştiren metotlarda her zaman async Task kullanın. Asenkron void metotlarını yalnızca olay işleyiciler için saklayın.
• İptal Jetonları: PDF oluşturma veya metin çıkarma gibi uzun süren işlemler için, kullanıcıların işlemi gerekirse iptal etmelerini sağlamak için iptal jetonlarını desteklemek iyi bir fikirdir. Bu, işlem artık gerekli olmadığında 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 asenkron işlemde olduğu gibi, yaşanabilecek hata durumlarını, özellikle dosya erişim sorunları veya geçersiz giriş verileri gibi, doğru bir şekilde yönettiğinizden 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