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

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 skomplikówanego i podatnego na błędy kodu. Programowanie asynchroniczne w C# uprościło to, umożliwiając deweloperom pisanie kodu, który wygląda jak kod synchroniczny, ale zachowuje się 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 stanowej, która zarządza kontynuacją kodu. Metoda async zazwyczaj zwraca obiekt Task (Task lub Task), aby przedstawić bieżą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);
}

Imports System
Imports System.Net.Http
Imports System.Threading.Tasks

Public Module Program
    Public 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 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
End Module

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

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

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

Najlepsze praktyki i przypadki brzegowe

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



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

// 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.

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

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. Poprzez zrozumieniuiuiuiuie wewnętrznej machiny stanowej i przestrzeganie najlepszych praktyk—takich jak priorytetowanie Task ponad async void, używanie ConfigureAwait(false) w bibliotekach i poprawne wdrażanie obsługi wyjątków—deweloperzy mogą tworzyć aplikacje, które radzą sobie z złożonymi zadaniami przetwarzania (takimi jak w Suite 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 wykorzystanie przetwarzania zadań asynchronicznych może dramatycznie poprawić szybkość i responsywność twojej aplikacji