Task Klass

Definition

Namnområde:
System.Threading.Tasks
Sammansättningar:
mscorlib.dll, System.Threading.Tasks.dll
Sammansättning:
mscorlib.dll
Sammansättning:
System.Threading.Tasks.dll
Sammansättning:
netstandard.dll

Representerar en asynkron åtgärd.

public ref class Task : IAsyncResult
public ref class Task : IAsyncResult, IDisposable
public class Task : IAsyncResult
public class Task : IAsyncResult, IDisposable
type Task = class
    interface IAsyncResult
type Task = class
    interface IAsyncResult
    interface IDisposable
Public Class Task
Implements IAsyncResult
Public Class Task
Implements IAsyncResult, IDisposable
Arv
Object
Task
Härledda
Implementeringar
IAsyncResult IDisposable

Kommentarer

Mer information om det här API:et finns i Kompletterande API-kommentarer för aktivitet.

Konstruktorer

Name Description
Task(Action, CancellationToken, TaskCreationOptions)

Initierar en ny Task med de angivna alternativen för åtgärd och skapande.
Task(Action, CancellationToken)

Initierar en ny Task med den angivna åtgärden och CancellationToken.
Task(Action, TaskCreationOptions)

Initierar en ny Task med de angivna alternativen för åtgärd och skapande.
Task(Action)

Initierar en ny Task med den angivna åtgärden.
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)

Initierar en ny Task med den angivna åtgärden, tillståndet och alternativen.
Task(Action<Object>, Object, CancellationToken)

Initierar en ny Task med den angivna åtgärden, tillståndet och CancellationToken.
Task(Action<Object>, Object, TaskCreationOptions)

Initierar en ny Task med den angivna åtgärden, tillståndet och alternativen.
Task(Action<Object>, Object)

Initierar en ny Task med den angivna åtgärden och tillståndet.

Egenskaper

Name Description
AsyncState

Hämtar tillståndsobjektet som angavs när det Task skapades, eller null om inget angavs.
CompletedTask

Hämtar en uppgift som redan har slutförts.
CreationOptions

Hämtar den TaskCreationOptions som används för att skapa den här uppgiften.
CurrentId

Returnerar ID:t för den för närvarande kör Task.
Exception

Hämtar det AggregateException som orsakade Task slutet i förtid. Om det Task har slutförts eller ännu inte har genererat några undantag returneras null.
Factory

Ger åtkomst till fabriksmetoder för att skapa och konfigurera Task och Task<TResult> instanser.
Id

Hämtar ett ID för den här Task instansen.
IsCanceled

Hämtar om den här Task instansen har slutfört körningen på grund av att den har avbrutits.
IsCompleted

Hämtar ett värde som anger om aktiviteten har slutförts.
IsCompletedSuccessfully

Hämtar om aktiviteten kördes till slutförande.
IsFaulted

Hämtar om den Task slutförda på grund av ett ohanterat undantag.
Status

Hämtar uppgiften TaskStatus .

Metoder

Name Description
ConfigureAwait(Boolean)

Konfigurerar en awaiter som används för att invänta detta Task.
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Skapar en fortsättning som tar emot tillståndsinformation från anroparen och en annulleringstoken och som körs när målet Task är klart. Fortsättningen körs baserat på en uppsättning angivna villkor och använder en angiven schemaläggare.
ContinueWith(Action<Task,Object>, Object, CancellationToken)

Skapar en fortsättning som tar emot tillståndsinformation från anroparen och en annulleringstoken och som körs asynkront när målet Task är klart.
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions)

Skapar en fortsättning som tar emot tillståndsinformation från anroparen och körs när målet Task är klart. Fortsättningen körs baserat på en uppsättning angivna villkor.
ContinueWith(Action<Task,Object>, Object, TaskScheduler)

Skapar en fortsättning som tar emot tillståndsinformation från anroparen och körs asynkront när målet Task är klart. Fortsättningen använder en angiven schemaläggare.
ContinueWith(Action<Task,Object>, Object)

Skapar en fortsättning som tar emot tillståndsinformation från anroparen och körs när målet Task är klart.
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Skapar en fortsättning som körs när målaktiviteten konkurrerar enligt angiven TaskContinuationOptions. Fortsättningen tar emot en annulleringstoken och använder en angiven schemaläggare.
ContinueWith(Action<Task>, CancellationToken)

Skapar en fortsättning som tar emot en annulleringstoken och körs asynkront när målet Task är klart.
ContinueWith(Action<Task>, TaskContinuationOptions)

Skapar en fortsättning som körs när målaktiviteten slutförs enligt angiven TaskContinuationOptions.
ContinueWith(Action<Task>, TaskScheduler)

Skapar en fortsättning som körs asynkront när målet Task är klart. Fortsättningen använder en angiven schemaläggare.
ContinueWith(Action<Task>)

Skapar en fortsättning som körs asynkront när målet Task är klart.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Skapar en fortsättning som körs baserat på de angivna alternativen för aktivitetsfortsättning när målet Task slutförs och returnerar ett värde. Fortsättningen tar emot tillståndsinformation från uppringaren och en annulleringstoken och använder den angivna schemaläggaren.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)

Skapar en fortsättning som körs asynkront när målet Task är klart och returnerar ett värde. Fortsättningen tar emot tillståndsinformation från uppringaren och en annulleringstoken.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskContinuationOptions)

Skapar en fortsättning som körs baserat på de angivna alternativen för aktivitetsfortsättning när målet Task är klart. Fortsättningen tar emot tillståndsinformation från uppringaren.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskScheduler)

Skapar en fortsättning som körs asynkront när målet Task är klart. Fortsättningen tar emot tillståndsinformation från anroparen och använder en angiven schemaläggare.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object)

Skapar en fortsättning som tar emot tillståndsinformation från anroparen och körs asynkront när målet Task slutförs och returnerar ett värde.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Skapar en fortsättning som körs enligt de angivna fortsättningsalternativen och returnerar ett värde. Fortsättningen skickas en annulleringstoken och använder en angiven schemaläggare.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)

Skapar en fortsättning som körs asynkront när målet Task är klart och returnerar ett värde. Fortsättningen får en annulleringstoken.
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)

Skapar en fortsättning som körs enligt de angivna fortsättningsalternativen och returnerar ett värde.
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler)

Skapar en fortsättning som körs asynkront när målet Task är klart och returnerar ett värde. Fortsättningen använder en angiven schemaläggare.
ContinueWith<TResult>(Func<Task,TResult>)

Skapar en fortsättning som körs asynkront när målet Task<TResult> är klart och returnerar ett värde.
Delay(Int32, CancellationToken)

Skapar en cancellable-uppgift som slutförs efter ett angivet antal millisekunder.
Delay(Int32)

Skapar en uppgift som slutförs efter ett angivet antal millisekunder.
Delay(TimeSpan, CancellationToken)

Skapar en cancellable-uppgift som slutförs efter ett angivet tidsintervall.
Delay(TimeSpan)

Skapar en aktivitet som slutförs efter ett angivet tidsintervall.
Dispose()

Släpper alla resurser som används av den aktuella instansen Task av klassen.
Dispose(Boolean)

TaskGör sig av med och frigör alla dess ohanterade resurser.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
FromCanceled(CancellationToken)

Skapar en Task som har slutförts på grund av annullering med en angiven annulleringstoken.
FromCanceled<TResult>(CancellationToken)

Skapar en Task<TResult> som har slutförts på grund av annullering med en angiven annulleringstoken.
FromException(Exception)

Skapar en Task som har slutförts med ett angivet undantag.
FromException<TResult>(Exception)

Skapar en Task<TResult> som har slutförts med ett angivet undantag.
FromResult<TResult>(TResult)

Skapar en Task<TResult> som har slutförts med det angivna resultatet.
GetAwaiter()

Hämtar en inväntare som används för att invänta detta Task.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
Run(Action, CancellationToken)

Köar det angivna arbetet som ska köras i trådpoolen och returnerar ett Task objekt som representerar det arbetet. Med en annulleringstoken kan arbetet avbrytas om det inte har startats ännu.
Run(Action)

Köar det angivna arbetet som ska köras i trådpoolen och returnerar ett Task objekt som representerar det arbetet.
Run(Func<Task>, CancellationToken)

Köar det angivna arbetet som ska köras i trådpoolen och returnerar en proxy för uppgiften som returneras av function. Med en annulleringstoken kan arbetet avbrytas om det inte har startats ännu.
Run(Func<Task>)

Köar det angivna arbetet som ska köras i trådpoolen och returnerar en proxy för uppgiften som returneras av function.
Run<TResult>(Func<Task<TResult>>, CancellationToken)

Köar det angivna arbetet som ska köras i trådpoolen och returnerar en proxy för den Task(TResult) som returneras av function.
Run<TResult>(Func<Task<TResult>>)

Köar det angivna arbetet som ska köras i trådpoolen och returnerar en proxy för den Task(TResult) som returneras av function. Med en annulleringstoken kan arbetet avbrytas om det inte har startats ännu.
Run<TResult>(Func<TResult>, CancellationToken)

Köar det angivna arbetet som ska köras i trådpoolen och returnerar ett Task(TResult) objekt som representerar det arbetet.
Run<TResult>(Func<TResult>)

Köar det angivna arbetet som ska köras i trådpoolen och returnerar ett Task<TResult> objekt som representerar det arbetet. Med en annulleringstoken kan arbetet avbrytas om det inte har startats ännu.
RunSynchronously()

Task Kör synkront på den aktuella TaskScheduler.
RunSynchronously(TaskScheduler)

Task Kör synkront på den TaskScheduler angivna.
Start()

TaskStartar , schemalägger den för körning till den aktuella TaskScheduler.
Start(TaskScheduler)

TaskStartar , schemalägger den för körning till angiven TaskScheduler.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
Wait()

Väntar på att slutföra körningen Task .
Wait(CancellationToken)

Väntar på att slutföra körningen Task . Väntetiden avslutas om en annulleringstoken avbryts innan aktiviteten slutförs.
Wait(Int32, CancellationToken)

Väntar på att slutföra körningen Task . Väntetiden avslutas om ett tidsgränsintervall förflutit eller en annulleringstoken avbryts innan aktiviteten slutförs.
Wait(Int32)

Väntar på att slutföra körningen Task inom ett angivet antal millisekunder.
Wait(TimeSpan)

Väntar på att slutföra körningen Task inom ett angivet tidsintervall.
WaitAll(Task[], CancellationToken)

Väntar på att alla angivna Task objekt ska slutföra körningen om inte väntan avbryts.
WaitAll(Task[], Int32, CancellationToken)

Väntar tills alla angivna Task objekt slutför körningen inom ett angivet antal millisekunder eller tills väntan avbryts.
WaitAll(Task[], Int32)

Väntar på att alla angivna Task objekt ska slutföra körningen inom ett angivet antal millisekunder.
WaitAll(Task[], TimeSpan)

Väntar på att alla angivna cancellable-objekt Task ska slutföra körningen inom ett angivet tidsintervall.
WaitAll(Task[])

Väntar på att alla angivna Task objekt ska slutföra körningen.
WaitAny(Task[], CancellationToken)

Väntar på att något av de angivna Task objekten ska slutföra körningen om inte väntan avbryts.
WaitAny(Task[], Int32, CancellationToken)

Väntar på att något av de angivna Task objekten ska slutföra körningen inom ett angivet antal millisekunder eller tills en annulleringstoken har avbrutits.
WaitAny(Task[], Int32)

Väntar på att något av de angivna Task objekten ska slutföra körningen inom ett angivet antal millisekunder.
WaitAny(Task[], TimeSpan)

Väntar på att något av de angivna Task objekten ska slutföra körningen inom ett angivet tidsintervall.
WaitAny(Task[])

Väntar på att något av de angivna Task objekten ska slutföra körningen.
WhenAll(IEnumerable<Task>)

Skapar en uppgift som slutförs när alla Task objekt i en uppräkningsbar samling har slutförts.
WhenAll(Task[])

Skapar en uppgift som ska slutföras när alla Task objekt i en matris har slutförts.
WhenAll<TResult>(IEnumerable<Task<TResult>>)

Skapar en uppgift som slutförs när alla Task<TResult> objekt i en uppräkningsbar samling har slutförts.
WhenAll<TResult>(Task<TResult>[])

Skapar en uppgift som ska slutföras när alla Task<TResult> objekt i en matris har slutförts.
WhenAny(IEnumerable<Task>)

Skapar en uppgift som ska slutföras när någon av de angivna uppgifterna har slutförts.
WhenAny(Task[])

Skapar en uppgift som ska slutföras när någon av de angivna uppgifterna har slutförts.
WhenAny<TResult>(IEnumerable<Task<TResult>>)

Skapar en uppgift som ska slutföras när någon av de angivna uppgifterna har slutförts.
WhenAny<TResult>(Task<TResult>[])

Skapar en uppgift som ska slutföras när någon av de angivna uppgifterna har slutförts.
Yield()

Skapar en väntande uppgift som asynkront ger tillbaka till den aktuella kontexten när den väntar.

Explicita gränssnittsimplementeringar

Name Description
IAsyncResult.AsyncWaitHandle

Hämtar en WaitHandle som kan användas för att vänta tills uppgiften har slutförts.
IAsyncResult.CompletedSynchronously

Hämtar en indikation på om åtgärden har slutförts synkront.

Tilläggsmetoder

Name Description
AsAsyncAction(Task)

Returnerar en Windows Runtime asynkron åtgärd som representerar en startad uppgift.
DispatcherOperationWait(Task, TimeSpan)

Väntar på den angivna tiden för att den underliggande ska DispatcherOperation slutföras.
DispatcherOperationWait(Task)

Väntar på obestämd tid för att den underliggande ska DispatcherOperation slutföras.
IsDispatcherOperationTask(Task)

Returnerar ett värde som anger om detta Task är associerat med en DispatcherOperation.

Gäller för

Trådsäkerhet

Alla medlemmar Taski , förutom Dispose(), är trådsäkra och kan användas från flera trådar samtidigt.

Se även