Async/Await란 무엇인가?

async와 await 키워드는 C#에서 비동기 메소드를 정의하는 데 사용됩니다. 비동기 메소드는 애플리케이션의 메인 스레드의 실행을 차단하지 않고 작업을 수행하여, 긴 작업을 수행할 때도 애플리케이션이 응답성을 유지할 수 있게 합니다.

• async: 이 키워드는 비동기 작업을 수행할 것으로 예상되는 메소드에 적용됩니다. 적어도 하나의 await 표현식을 포함하고 있음을 나타냅니다.
• await: 이 키워드는 메소드 실행을 기다리고 있는 작업이 완료될 때까지 일시 중지하는 데 사용됩니다. 작업을 기다리는 동안 다른 작업을 실행할 수 있도록 스레드가 자유로워지도록 보장합니다.

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

비동기 메서드는 작업 완료를 기다리는 동안 메인 스레드를 해방하여 다른 작업을 처리하도록 함으로써 반응성을 향상시킵니다.

비동기 프로그래밍의 주요 이점

• 비차단 작업: 비동기 프로그래밍을 통해 파일 I/O나 네트워크 요청과 같은 시간이 많이 소요되는 작업이 메인 스레드를 차단하지 않습니다. 웹 애플리케이션에서는 비차단 작업이 서버가 여러 요청을 동시 처리할 수 있도록 보장하기 때문에 이는 중요합니다.
• 향상된 확장성: 비동기 키워드를 사용하면 적은 수의 스레드로 더 많은 동시 작업을 처리할 수 있으므로 확장성이 향상됩니다.
• 향상된 사용자 경험: 데스크탑이나 웹 애플리케이션의 경우, 비동기 작업을 사용하면 백그라운드에서 작업이 실행되는 동안 UI가 사용자 입력에 반응하게 됩니다.

IronPDF 개요

IronPDF 는 .NET 개발자가 웹 또는 데스크탑 환경을 위한 애플리케이션에 직접 PDF 기능을 통합할 수 있게 해줍니다. 다음은 IronPDF가 제공하는 주요 기능입니다:

• HTML을 PDF로 변환: IronPDF는 HTML 콘텐츠 (CSS, 이미지, JavaScript 포함)를 완전히 포맷된 PDF로 변환할 수 있습니다. 이는 동적 웹 페이지나 보고서를 PDF로 렌더링할 때 특히 유용합니다.
• PDF 편집: IronPDF를 사용하여 기존 PDF 문서에 텍스트, 이미지, 그래픽을 추가하고, 기존 페이지의 콘텐츠를 편집할 수 있습니다.
• 텍스트 및 이미지 추출: 이 라이브러리를 사용하면 PDF에서 텍스트와 이미지를 추출할 수 있어, PDF 콘텐츠를 쉽게 분석하고 파싱할 수 있게 만듭니다.
• 양식 채우기: IronPDF는 PDF의 양식 필드를 채우는 것을 지원하며, 이는 맞춤화된 문서를 생성할 때 유용합니다.
• 워터마크 추가: PDF 문서에 브랜드 또는 저작권 보호를 위한 워터마크를 추가하는 것도 가능합니다.

왜 비동기/대기와 IronPDF를 함께 사용해야 할까요?

IronPDF는 네이티브 비동기가 아니지만, 대부분의 PDF 처리 작업의 I/O 중점 특성 때문에 비동기/대기 패턴에 잘 맞습니다. 예를 들어, HTML을 PDF로 변환하거나 큰 PDF 문서를 로드하는 작업은 상당한 시간이 소요될 수 있지만, 비동기적으로 수행하여 메인 스레드를 차단하지 않도록 할 수 있습니다.

IronPDF가 비동기 프로그래밍에 잘 맞는 몇 가지 예시는 다음과 같습니다:

• PDF 생성: 애플리케이션이 동적 콘텐츠에 기반하여 여러 PDF를 생성해야 한다면, 이러한 프로세스를 비동기적으로 수행하면 PDF가 생성되는 동안 시스템이 반응성을 유지할 수 있습니다.
• PDF 조작: 큰 PDF를 수정해야 할 경우, 예를 들어 워터마크를 추가하거나 문서를 병합하는 경우, 이러한 작업을 비동기적으로 수행하면 이러한 시간이 많이 소요되는 작업이 백그라운드에서 처리되는 동안 애플리케이션이 멈추지 않도록 보장합니다.
• 파일 I/O: PDF를 읽고 쓰는 작업은 I/O 중심 작업입니다. 비동기 프로그래밍은 시스템 리소스를 확보하고 불필요한 차단을 피할 수 있는 이러한 작업에 완벽합니다.

기본 예제: IronPDF로 비동기 PDF 생성

IronPDF를 사용하여 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"));
    }
}

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

이것이 작동하는 방식

1. HTML을 PDF로 변환기 생성:
   ChromePdfRenderer 클래스는 HTML 콘텐츠를 PDF로 변환하는 데 사용됩니다. 이 예제에서는 단순한 HTML 콘텐츠를 문자열("

   Async PDF Example

   ")로 전달하지만, 실제 애플리케이션에서는 보고서 템플릿과 같은 동적 HTML이 될 수 있습니다.

2. 비동기 PDF 생성을 위한 Task.Run 사용:
   RenderHtmlAsPdf 메서드는 기본적으로 비동기로 수행되지 않으므로, Task.Run()을 사용하여 PDF 생성을 백그라운드 스레드로 옮깁니다. 이는 특히 크거나 복잡한 문서를 다룰 때 PDF 생성이 리소스를 많이 소모하고 시간이 많이 소요될 수 있기 때문에 중요합니다.

3. PDF 저장:
   PDF 생성이 완료되면 pdf.SaveAs()을 사용하여 파일 시스템에 저장됩니다. 이 I/O 작업도 Task.Run() 안에 감싸져 있어 파일을 저장하는 동안 메인 스레드를 차단하지 않도록 합니다.

4. 작업 대기:
   await 키워드는 각 비동기 작업이 다음 작업이 시작되기 전에 완료되도록 보장합니다. PDF 생성이 완료될 때까지 기다리는 동안 주 스레드는 다른 작업(예: 웹 애플리케이션에서 다른 HTTP 요청 처리)을 할 수 있습니다.

IronPDF를 사용한 여러 작업 처리

큰 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"));
    }
}

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

이 예제에서는 PDF 파일을 불러와 새 파일을 생성하고, 워터마크를 추가하고, 두 PDF를 병합하고 저장하되, 주 스레드를 차단하지 않습니다.

IronPDF와의 비동기 작업을 위한 모범 사례

• 스레드 풀 고려사항: IronPDF는 처리를 위해 백그라운드 스레드에 의존하므로, Task.Run()을 사용할 때는 스레드 풀을 유념하세요. 고빈도 작업의 경우, 전용 백그라운드 서비스 사용이나 작업을 큐에 넣어 스레드 풀이 과부하되지 않도록 고려하세요.
• Async void 메서드 피하기: 비동기 작업을 수행하는 메서드에는 항상 async Task을 사용하세요. 비동기 void 메서드는 이벤트 핸들러에 예약하세요.
• 취소 토큰: 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 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

• 오류 처리: 모든 비동기 작업과 마찬가지로, PDF 처리 중 발생할 수 있는 예외(예: 파일 액세스 문제나 잘못된 입력 데이터)에 대한 적절한 오류 처리를 보장하세요.

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