Opanowanie Async/Await C# w .NET 10: Niezbędny przewodnik dla skalowalnych aplikacji

Współczesne tworzenie oprogramowania wymaga szybkości, responsywności i nieporównywalnej skalowalności. W świecie aplikacji webowych i rozwiązań enterprise, blokowanie wątku UI lub nadmierne korzystanie z zasobów serwera jest po prostu niedopuszczalne. Tutaj wchodzi do gry programowanie asynchroniczne, napędzane przez potężne słowa kluczowe async i await w C#, które staje się nie tylko funkcją, ale wymaganym fundamentem architektonicznym.

Dla programistów wykorzystujących biblioteki wysokowydajnościowe, takie jak pakiet Iron Software do generowania PDF, manipulacji obrazami i OCR, zrozumienie jak pisać asynchroniczny kod jest kluczem do tworzenia efektywnego kodu, który w pełni wykorzystuje bibliotekę Task Parallel .NET.

Zagłębimy się w mechanizmy async/await C#, badając, jak ta zmiana paradygmatu przekształca powolne synchroniczne programowanie w operacje asynchroniczne o wysokiej przepustowości, i pokazujemy, jak Iron Software pomaga przedsiębiorstwom osiągnąć maksymalną wydajność.

Podstawy Programowania Asynchronicznego

Przed async i await, operacje asynchroniczne były zarządzane za pomocą uciążliwych wywołań zwrotnych i ręcznych operacji klasy Task, prowadzących do skomplikowanego i podatnego na błędy kodu. Programowanie asynchroniczne w C# uprościło to, umożliwiając programistom pisanie kodu, który wygląda jak kod synchroniczny, ale działa asynchronicznie.

Dwa główne komponenty to:

1. Słowo kluczowe async: Modyfikator async oznacza metodę jako metodę async, która może zawierać wyrażenia await. Co ważne, oznaczenie metody jako async nie uruchamia jej automatycznie w tle. Jedynie umożliwia kompilatorowi generowanie zaawansowanej maszyny stanów zarządzającej kontynuacją kodu. Metoda asynchroniczna zazwyczaj zwraca obiekt Task (Task lub Task), aby reprezentować trwające zadanie asynchroniczne.

2. Słowo kluczowe await: Słowo kluczowe await jest magicznym komponentem. Gdy napotkane zostanie wyrażenie await, metoda sprawdza, czy oczekiwane zadanie zostało zakończone. Jeśli nie, metoda natychmiast wstrzymuje wykonanie i zwraca kontrolę do metody wywołującej (lub wywołującego). To zwalnia bieżący wątek (często główny wątek lub wątek puli wątków) do obsługi innych żądań lub zadań. Gdy zadanie się kończy, reszta metody jest rejestrowana jako kontynuacja i jest zaplanowana do ponownego wykonania.

Oto podstawowy przykład kodu:

public static async Task<string> DownloadDataAsync(string url)
{
    // The async keyword allows us to use await
    using var client = new HttpClient();
    
    // await task: Control returns to the caller while the HTTP call happens
    string data = await client.GetStringAsync(url); // I/O-bound 
    
    // The code after the await expression runs once the task finishes
    return $"Data length: {data.Length}";
}

// Modern entry point for console apps
public static async Task Main(string[] args) 
{
    // This is the static async task main entry point
    var result = await DownloadDataAsync("https://api.example.com/data");
    Console.WriteLine(result);
}

public static async Task<string> DownloadDataAsync(string url)
{
    // The async keyword allows us to use await
    using var client = new HttpClient();
    
    // await task: Control returns to the caller while the HTTP call happens
    string data = await client.GetStringAsync(url); // I/O-bound 
    
    // The code after the await expression runs once the task finishes
    return $"Data length: {data.Length}";
}

// Modern entry point for console apps
public static async Task Main(string[] args) 
{
    // This is the static async task main entry point
    var result = await DownloadDataAsync("https://api.example.com/data");
    Console.WriteLine(result);
}

Public Shared Async Function DownloadDataAsync(url As String) As Task(Of String)
    ' The async keyword allows us to use await
    Using client As New HttpClient()

        ' await task: Control returns to the caller while the HTTP call happens
        Dim data As String = Await client.GetStringAsync(url) ' I/O-bound 

        ' The code after the await expression runs once the task finishes
        Return $"Data length: {data.Length}"
    End Using
End Function

' Modern entry point for console apps
Public Shared Async Function Main(args As String()) As Task
    ' This is the static async task main entry point
    Dim result As String = Await DownloadDataAsync("https://api.example.com/data")
    Console.WriteLine(result)
End Function

Public Shared Async Function DownloadDataAsync(url As String) As Task(Of String)
    ' The async keyword allows us to use await
    Using client As New HttpClient()

        ' await task: Control returns to the caller while the HTTP call happens
        Dim data As String = Await client.GetStringAsync(url) ' I/O-bound 

        ' The code after the await expression runs once the task finishes
        Return $"Data length: {data.Length}"
    End Using
End Function

' Modern entry point for console apps
Public Shared Async Function Main(args As String()) As Task
    ' This is the static async task main entry point
    Dim result As String = Await DownloadDataAsync("https://api.example.com/data")
    Console.WriteLine(result)
End Function

Użycie static async task main to nowoczesny standard, eliminujący konieczność blokowania głównego wątku przy użyciu starszych metod, takich jak .Wait() lub .Result.

Wydajność i integracja z produktami Iron Software

Chociaż Task jest standardowym typem zwrotnym dla kodu asynchronicznego, zaawansowane asynchroniczne programowanie w .NET 10 często używa ValueTask dla znacznych zysków wydajnościowych w "gorących ścieżkach", gdzie prawdopodobne jest synchroniczne ukończenie (np. pobieranie wartości z pamięci podręcznej). ValueTask unika alokacji pamięci, co czyni go krytycznym dla aplikacji o wysokiej przepustowości.

Stosowanie operacji asynchronicznych w produktach Iron Software

Produkty Iron Software, takie jak IronOCR (Rozpoznawanie tekstu) i IronPDF (Generowanie PDF), są idealnymi kandydatami do wykorzystania wywołań async. Operacje takie jak konwersja dużego dokumentu HTML do PDF lub skanowanie setek stron obrazów pod kątem tekstu to zwykle zadania obciążające procesor lub obejmujące I/O systemu plików, czerpiące ogromne korzyści z metod asynchronicznych.

Kiedy korzystasz z metod synchronicznych i asynchronicznych dostarczanych przez Iron Software, zapewniasz, że twoja aplikacja pozostaje wysoce responsywna.

Rozważ użycie IronPDF do tworzenia dokumentu z określonego URL:

public static async Task GeneratePdfFromUrlAsync(string url, string outputFileName)
{
    // 1. Initialize the renderer
    var renderer = new IronPdf.ChromePdfRenderer();

    // Optional: Set rendering options if needed (e.g., margins, headers)
    renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;

    // 2. The core asynchronous operation: Fetch and render the URL content
    // This is an I/O-bound task that releases the calling thread.
    var pdf = await renderer.RenderUrlAsPdfAsync(url);

    // 3. Save the PDF file asynchronously
    await Task.Run(() =>
    {
        // This is the synchronous method you confirmed exists
        pdf.SaveAs(outputFileName);
    });
}

public static async Task GeneratePdfFromUrlAsync(string url, string outputFileName)
{
    // 1. Initialize the renderer
    var renderer = new IronPdf.ChromePdfRenderer();

    // Optional: Set rendering options if needed (e.g., margins, headers)
    renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;

    // 2. The core asynchronous operation: Fetch and render the URL content
    // This is an I/O-bound task that releases the calling thread.
    var pdf = await renderer.RenderUrlAsPdfAsync(url);

    // 3. Save the PDF file asynchronously
    await Task.Run(() =>
    {
        // This is the synchronous method you confirmed exists
        pdf.SaveAs(outputFileName);
    });
}

Imports System.Threading.Tasks
Imports IronPdf

Public Module PdfGenerator
    Public Async Function GeneratePdfFromUrlAsync(url As String, outputFileName As String) As Task
        ' 1. Initialize the renderer
        Dim renderer As New ChromePdfRenderer()

        ' Optional: Set rendering options if needed (e.g., margins, headers)
        renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A4

        ' 2. The core asynchronous operation: Fetch and render the URL content
        ' This is an I/O-bound task that releases the calling thread.
        Dim pdf = Await renderer.RenderUrlAsPdfAsync(url)

        ' 3. Save the PDF file asynchronously
        Await Task.Run(Sub()
                           ' This is the synchronous method you confirmed exists
                           pdf.SaveAs(outputFileName)
                       End Sub)
    End Function
End Module

Imports System.Threading.Tasks
Imports IronPdf

Public Module PdfGenerator
    Public Async Function GeneratePdfFromUrlAsync(url As String, outputFileName As String) As Task
        ' 1. Initialize the renderer
        Dim renderer As New ChromePdfRenderer()

        ' Optional: Set rendering options if needed (e.g., margins, headers)
        renderer.RenderingOptions.PaperSize = Rendering.PdfPaperSize.A4

        ' 2. The core asynchronous operation: Fetch and render the URL content
        ' This is an I/O-bound task that releases the calling thread.
        Dim pdf = Await renderer.RenderUrlAsPdfAsync(url)

        ' 3. Save the PDF file asynchronously
        Await Task.Run(Sub()
                           ' This is the synchronous method you confirmed exists
                           pdf.SaveAs(outputFileName)
                       End Sub)
    End Function
End Module

PDF generowany przy użyciu metod asynchronicznych

Korzystając z metody asynchronicznej RenderHtmlAsPdfAsync(), zapobiegamy zamarzaniu lub blokowaniu aplikacji podczas przetwarzania dużych dokumentów. To pokazuje, jak efektywnie pisać kod asynchroniczny dla złożonego przetwarzania.

Najlepsze praktyki i przypadki brzegowe

1. Obsługa wielu zadań i I/O

Aby zmaksymalizować efektywność, należy inicjować wiele zadań jednocześnie podczas oczekiwania na niezależne prace I/O, takie jak pobieranie danych z zdalnego serwera czy wykonywanie zapytań do bazy danych.

public async Task<string[]> FetchAllDataAsync(string url1, string url2)
{
    // Creating tasks starts the async operation immediately
    Task<string> taskA = DownloadDataAsync(url1); 
    Task<string> taskB = DownloadDataAsync(url2);

    // Wait for all the tasks to complete simultaneously
    string[] results = await Task.WhenAll(taskA, taskB);
    return results;
}

public async Task<string[]> FetchAllDataAsync(string url1, string url2)
{
    // Creating tasks starts the async operation immediately
    Task<string> taskA = DownloadDataAsync(url1); 
    Task<string> taskB = DownloadDataAsync(url2);

    // Wait for all the tasks to complete simultaneously
    string[] results = await Task.WhenAll(taskA, taskB);
    return results;
}

Option Strict On
Option Infer On

Public Async Function FetchAllDataAsync(url1 As String, url2 As String) As Task(Of String())
    ' Creating tasks starts the async operation immediately
    Dim taskA As Task(Of String) = DownloadDataAsync(url1)
    Dim taskB As Task(Of String) = DownloadDataAsync(url2)

    ' Wait for all the tasks to complete simultaneously
    Dim results As String() = Await Task.WhenAll(taskA, taskB)
    Return results
End Function

Option Strict On
Option Infer On

Public Async Function FetchAllDataAsync(url1 As String, url2 As String) As Task(Of String())
    ' Creating tasks starts the async operation immediately
    Dim taskA As Task(Of String) = DownloadDataAsync(url1)
    Dim taskB As Task(Of String) = DownloadDataAsync(url2)

    ' Wait for all the tasks to complete simultaneously
    Dim results As String() = Await Task.WhenAll(taskA, taskB)
    Return results
End Function

To standardowy wzorzec tworzenia zadań, które działają jednocześnie, znacznie przyspieszając czas reakcji aplikacji dzięki wykorzystaniu nieblokujących operacji asynchronicznych.

2. Synchronization Context i ConfigureAwait(false)

Gdy oczekiwane zadanie się kończy, domyślne zachowanie to przechwycenie kontekstu synchronizacji i zapewnienie, że kontynuacja działa na tym samym wątku (jak wątek UI). Jest to kluczowe dla aplikacji UI, ale powoduje zbędne nadmiary w kodzie po stronie serwera lub biblioteki.

Użycie ConfigureAwait(false) informuje środowisko uruchomieniowe, że kod po wywołaniu await może być wykonywany na dowolnych dostępnych wątkach z puli wątków. To krytyczna praktyka dla deweloperów bibliotek, zapewniająca maksymalną wydajność operacji asynchronicznych:

// Critical for shared libraries to avoid deadlocks and improve throughput
var data = await GetVarDataFromRemoteServer().ConfigureAwait(false); 
// This code continues on any thread, improving resource usage.

// Critical for shared libraries to avoid deadlocks and improve throughput
var data = await GetVarDataFromRemoteServer().ConfigureAwait(false); 
// This code continues on any thread, improving resource usage.

' Critical for shared libraries to avoid deadlocks and improve throughput
Dim data = Await GetVarDataFromRemoteServer().ConfigureAwait(False)
' This code continues on any thread, improving resource usage.

' Critical for shared libraries to avoid deadlocks and improve throughput
Dim data = Await GetVarDataFromRemoteServer().ConfigureAwait(False)
' This code continues on any thread, improving resource usage.

3. Niebezpieczeństwo async void

Jedną z najważniejszych zasad w programowaniu async jest nigdy nie używać async void z wyjątkiem asynchronicznych obsługiwaczy zdarzeń. Na przykład, metoda obsługująca kliknięcie przycisku zazwyczaj używa async void:

private async void Button_Click(object sender, EventArgs e) // event handler
{
    // This is one of the few places async void is acceptable
    await GenerateReportAsync(html);
}

private async void Button_Click(object sender, EventArgs e) // event handler
{
    // This is one of the few places async void is acceptable
    await GenerateReportAsync(html);
}

Private Async Sub Button_Click(sender As Object, e As EventArgs) Handles Button.Click ' event handler
    ' This is one of the few places async void is acceptable
    Await GenerateReportAsync(html)
End Sub

Private Async Sub Button_Click(sender As Object, e As EventArgs) Handles Button.Click ' event handler
    ' This is one of the few places async void is acceptable
    Await GenerateReportAsync(html)
End Sub

Wszelkie inne użycie metod async void jest stanowczo odradzane. Ponieważ metoda async void nie może być oczekiwana, wątek wywołujący nie może śledzić jej ukończenia ani niezawodnie obsługiwać wyjątków, co sprawia, że obsługa błędów jest problematyczna. Zawsze zwracaj Task lub Task dla wszystkich innych metod asynchronicznych.

4. Obsługa wyjątków

Solidna obsługa wyjątków jest istotna. Kiedy operacja asynchroniczna kończy się niepowodzeniem (np. wywołanie usługi webowej napotyka błąd), wyjątek jest przechowywany w obiekcie zadania. Gdy oczekujesz na zadanie, wyrażenie await ponownie wyrzuca wyjątek na bieżący wątek (ten, który wznawia kontynuację), pozwalając standardowym blokom try...catch działać skutecznie w obsłudze wyjątków.

Wnioski

Wzorzec async i await w C# to cecha zmienności paradygmatu, przenosząca deweloperów z kruchych metod synchronicznych do odpornych, skalowalnych metod asynchronicznych. Rozumiejąc wewnętrzny mechanizm stanu i przestrzegając najlepszych praktyk—jak priorytetyzowanie Task nad async void, używanie ConfigureAwait(false) w bibliotekach i prawidłowe implementowanie obsługi wyjątków—programiści mogą tworzyć aplikacje, które obsługują złożone zadania przetwarzania (jak te w pakiecie Iron Software) z wyjątkową wydajnością.

Iron Software zobowiązuje się do rozwijania produktów mających na celu wysoką wydajność programowania asynchronicznego w ich rdzeniu, zapewniając, że twoje praktyki pisania kodu prowadzą do maksymalnej przepustowości. Odkryj świat Iron Software i zobacz, jak korzystanie z przetwarzania zadań asynchronicznych może dramatycznie poprawić szybkość i responsywność twojej aplikacji