CA1849: Roep asynchrone methoden aan binnen een asynchrone methode

Eigenschap	Waarde
Regel-id	CA1849
Titel	Roep asynchrone methoden aan binnen een asynchrone methode
Categorie	Prestaties
Fix kan brekend of niet-brekend zijn	Niet-brekend
Standaard ingeschakeld in .NET 10	Nee
Toepasselijke talen	C# en Visual Basic

Oorzaak

Alle methoden waarbij een equivalent met Async-achtervoegsel bestaat, produceren deze waarschuwing wanneer deze wordt aangeroepen vanuit een methode voor het retourneren van taken. Daarnaast veroorzaken het aanroepen van Task.Wait(), Task<T>.Result, of Task.GetAwaiter().GetResult() deze waarschuwing.

Beschrijving van regel

In een methode die al asynchroon is, moeten aanroepen naar andere methoden naar hun asynchrone versies gaan, indien beschikbaar.

Hoe schendingen op te lossen

Schending:

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

Herstel:

Wacht op de asynchrone versie van de methode:

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

Wanneer waarschuwingen onderdrukken

Het is veilig om een waarschuwing van deze regel te onderdrukken in het geval dat er twee afzonderlijke codepaden zijn voor synchronisatie en asynchrone code, met behulp van een if-voorwaarde. Als er ook een controle is of de taak is opgelost, is het veilig om synchronisatiemethoden en -eigenschappen te gebruiken.

Een waarschuwing onderdrukken

Als u slechts één schending wilt onderdrukken, voegt u preprocessorrichtlijnen toe aan uw bronbestand om de regel uit te schakelen en vervolgens opnieuw in te schakelen.

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

Als u de regel voor een bestand, map of project wilt uitschakelen, stelt u de ernst none ervan in op het configuratiebestand.

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

Zie voor meer informatie Hoe codeanalysewaarschuwingen te onderdrukken.

Zie ook

• Prestatieregels