Share via

CA1849: Volání asynchronních metod v asynchronní metodě

  • Článek
Vlastnost Hodnota
ID pravidla CA1849
Název Volání asynchronních metod v asynchronní metodě
Kategorie Výkon
Oprava způsobující chybu nebo chybu způsobující chybu Nenarušující
Povoleno ve výchozím nastavení v .NET 8 No

Příčina

Všechny metody, ve kterých existuje ekvivalent s příponou Async, vytvoří toto upozornění při volání z metody vracející úlohu. Kromě toho volání Task.Wait(), Task<T>.Resultnebo Task.GetAwaiter().GetResult() vyvolá toto upozornění.

Popis pravidla

V metodě, která je již asynchronní, by volání jiných metod měla být jejich asynchronní verze, kde existují.

Jak opravit porušení

Porušení:

Task DoAsync()
{
    file.Read(buffer, 0, 10);
}

Oprava:

Vyčkejte asynchronní verzi metody:

async Task DoAsync()
{
    await file.ReadAsync(buffer, 0, 10);
}

Kdy potlačit upozornění

Je bezpečné potlačit upozornění z tohoto pravidla v případě, že existují dvě samostatné cesty kódu pro synchronizaci a asynchronní kód pomocí podmínky if. Pokud existuje také kontrola, jestli se úloha vyřešila, je bezpečné používat metody a vlastnosti synchronizace.

Potlačení upozornění

Pokud chcete pouze potlačit jedno porušení, přidejte do zdrojového souboru direktivy preprocesoru, abyste pravidlo zakázali a znovu povolili.

#pragma warning disable CA1849
// The code that's violating the rule is on this line.
#pragma warning restore CA1849

Pokud chcete pravidlo pro soubor, složku nebo projekt zakázat, nastavte jeho závažnost v none konfiguračním souboru.

[*.{cs,vb}]
dotnet_diagnostic.CA1849.severity = none

Další informace naleznete v tématu Jak potlačit upozornění analýzy kódu.

Viz také