CA2008: Geen taken maken zonder een TaskScheduler door te geven

Oorzaak

Het maken van een taak of een vervolgbewerking maakt gebruik van een methodeoverload die geen TaskScheduler-parameter opgeeft.

Beschrijving van regel

De volgende methoden voor het maken en vervolgen van .NET-taken hebben overbelastingen waarmee een TaskScheduler exemplaar kan worden opgegeven of weggelaten:

• System.Threading.Tasks.TaskFactory.StartNew Methoden
• System.Threading.Tasks.Task.ContinueWith Methoden

Geef altijd een expliciet TaskScheduler argument op om de standaardwaarde Current te voorkomen, waarvan het gedrag wordt gedefinieerd door de aanroeper en kan variëren tijdens runtime. Current retourneert de scheduler die is gekoppeld aan wat Task momenteel wordt uitgevoerd op die thread. Als er geen dergelijke taak is, retourneert het Default, wat de threadpool vertegenwoordigt. Het gebruik van Current kan leiden tot deadlocks of problemen met de reactietijd van de gebruikersinterface in sommige situaties, wanneer het was bedoeld om de taak in de threadpool te maken, maar in plaats daarvan wacht het programma om terug te keren naar de UI-thread.

Zie Nieuwe TaskCreationOptions en TaskContinuationOptions in .NET Framework 4.5 voor meer informatie en gedetailleerde voorbeelden.

Schendingen oplossen

Als u schendingen wilt oplossen, roept u de overbelasting van de methode aan die een TaskScheduler en expliciet doorgeeft Default of Current om de intentie duidelijk te maken.

Example

// This code violates the rule.
var badTask = Task.Factory.StartNew(
    () =>
    {
        // ...
    }
);
badTask.ContinueWith(
    t =>
    {
        // ...
    }
);

// This code satisfies the rule.
var goodTask = Task.Factory.StartNew(
    () =>
    {
        // ...
    },
    CancellationToken.None,
    TaskCreationOptions.None,
    TaskScheduler.Default
);
goodTask.ContinueWith(
    t =>
    {
        // ...
    },
    CancellationToken.None,
    TaskContinuationOptions.None,
    TaskScheduler.Default
);

Wanneer waarschuwingen onderdrukken

Deze waarschuwing is voornamelijk bedoeld voor bibliotheken, waarbij de code kan worden uitgevoerd in willekeurige omgevingen en waar code geen aannames mag doen over de omgeving of hoe de aanroeper van de methode deze aanroept of wacht erop. Het kan handig zijn om de waarschuwing te onderdrukken voor projecten die toepassingscode vertegenwoordigen in plaats van bibliotheekcode.

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 CA2008
// The code that's violating the rule is on this line.
#pragma warning restore CA2008

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.CA2008.severity = none

Voor meer informatie, zie Hoe codeanalysewaarschuwingen onderdrukken.

Zie ook

• Nieuwe TaskCreationOptions en TaskContinuationOptions in .NET Framework 4.5
• VSTHRD105 - Vermijd overbelasting van methoden die uitgaan van TaskScheduler.Current
• CA2007: Wacht niet rechtstreeks op een taak
• Betrouwbaarheidsregels