Task Klasa

Definicja

Przestrzeń nazw:

System.Threading.Tasks

Zestaw:

System.Runtime.dll

Źródło:

Task.cs

Reprezentuje operację asynchroniczną.

public ref class Task : IAsyncResult, IDisposable

public class Task : IAsyncResult, IDisposable

type Task = class
    interface IAsyncResult
    interface IDisposable

Public Class Task
Implements IAsyncResult, IDisposable

Dziedziczenie

Object

Task

Pochodne

System.Threading.Tasks.Task<TResult>

Implementuje

IAsyncResult IDisposable

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz uwagi dotyczące dodatkowego interfejsu API zadania.

Konstruktory

Task(Action)	Inicjuje nową Task z określoną akcją.
Task(Action, CancellationToken)	Inicjuje nową Task z określoną akcją i CancellationToken.
Task(Action, CancellationToken, TaskCreationOptions)	Inicjuje nową Task z określonymi opcjami akcji i tworzenia.
Task(Action, TaskCreationOptions)	Inicjuje nową Task z określonymi opcjami akcji i tworzenia.
Task(Action<Object>, Object)	Inicjuje nową Task z określoną akcją i stanem.
Task(Action<Object>, Object, CancellationToken)	Inicjuje nową Task z określoną akcją, stanem i CancellationToken.
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)	Inicjuje nową Task z określoną akcją, stanem i opcjami.
Task(Action<Object>, Object, TaskCreationOptions)	Inicjuje nową Task z określoną akcją, stanem i opcjami.

Właściwości

AsyncState	Pobiera obiekt stanu podany podczas tworzenia Task lub ma wartość null, jeśli żadna z nich nie została podana.
CompletedTask	Pobiera zadanie, które zostało już ukończone pomyślnie.
CreationOptions	Pobiera TaskCreationOptions użyte do utworzenia tego zadania.
CurrentId	Zwraca identyfikator aktualnie wykonywanego Task.
Exception	Pobiera AggregateException, które spowodowały przedwczesne zakończenie Task. Jeśli Task została ukończona pomyślnie lub nie zgłosiła jeszcze żadnych wyjątków, zostanie zwrócona null.
Factory	Zapewnia dostęp do metod fabrycznych do tworzenia i konfigurowania wystąpień Task i Task<TResult>.
Id	Pobiera identyfikator dla tego wystąpienia Task.
IsCanceled	Pobiera, czy to wystąpienie Task zostało ukończone z powodu anulowania.
IsCompleted	Pobiera wartość wskazującą, czy zadanie zostało ukończone.
IsCompletedSuccessfully	Pobiera, czy zadanie było uruchamiane do ukończenia.
IsFaulted	Pobiera, czy Task ukończone z powodu nieobsługiwanego wyjątku.
Status	Pobiera TaskStatus tego zadania.

Metody

ConfigureAwait(Boolean)	Konfiguruje obiekt awaiter używany do oczekiwania na ten Task.
ConfigureAwait(ConfigureAwaitOptions)	Konfiguruje obiekt awaiter używany do oczekiwania na ten Task.
ContinueWith(Action<Task,Object>, Object)	Tworzy kontynuację odbierającą informacje o stanie dostarczone przez obiekt wywołujący i wykonywaną po zakończeniu Task docelowej.
ContinueWith(Action<Task,Object>, Object, CancellationToken)	Tworzy kontynuację, która odbiera informacje o stanie dostarczonym przez obiekt wywołujący i token anulowania oraz wykonuje asynchronicznie po zakończeniu Task docelowej.
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Tworzy kontynuację, która odbiera informacje o stanie dostarczonym przez obiekt wywołujący i token anulowania oraz jest wykonywana po zakończeniu Task docelowej. Kontynuacja jest wykonywana na podstawie zestawu określonych warunków i używa określonego harmonogramu.
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions)	Tworzy kontynuację odbierającą informacje o stanie dostarczone przez obiekt wywołujący i wykonywaną po zakończeniu Task docelowej. Kontynuacja jest wykonywana na podstawie zestawu określonych warunków.
ContinueWith(Action<Task,Object>, Object, TaskScheduler)	Tworzy kontynuację, która odbiera informacje o stanie dostarczone przez obiekt wywołujący i wykonuje asynchronicznie po zakończeniu Task docelowej. Kontynuacja używa określonego harmonogramu.
ContinueWith(Action<Task>)	Tworzy kontynuację wykonywaną asynchronicznie po zakończeniu Task docelowej.
ContinueWith(Action<Task>, CancellationToken)	Tworzy kontynuację, która odbiera token anulowania i wykonuje asynchronicznie po zakończeniu Task docelowej.
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Tworzy kontynuację wykonywaną, gdy zadanie docelowe konkuruje zgodnie z określonym TaskContinuationOptions. Kontynuacja odbiera token anulowania i używa określonego harmonogramu.
ContinueWith(Action<Task>, TaskContinuationOptions)	Tworzy kontynuację wykonywaną po zakończeniu zadania docelowego zgodnie z określonym TaskContinuationOptions.
ContinueWith(Action<Task>, TaskScheduler)	Tworzy kontynuację wykonywaną asynchronicznie po zakończeniu Task docelowej. Kontynuacja używa określonego harmonogramu.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object)	Tworzy kontynuację, która odbiera informacje o stanie dostarczonym przez obiekt wywołujący i wykonuje asynchronicznie po zakończeniu Task docelowej i zwraca wartość.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)	Tworzy kontynuację, która wykonuje asynchronicznie po zakończeniu Task docelowej i zwraca wartość. Kontynuacja odbiera informacje o stanie dostarczone przez obiekt wywołujący i token anulowania.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Tworzy kontynuację wykonywaną na podstawie określonych opcji kontynuacji zadania, gdy Task docelowa zostanie ukończona i zwróci wartość. Kontynuacja odbiera informacje o stanie dostarczone przez obiekt wywołujący i token anulowania i używa określonego harmonogramu.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskContinuationOptions)	Tworzy kontynuację wykonywaną na podstawie określonych opcji kontynuacji zadania po zakończeniu Task docelowej. Kontynuacja odbiera informacje o stanie dostarczone przez obiekt wywołujący.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskScheduler)	Tworzy kontynuację wykonywaną asynchronicznie po zakończeniu Task docelowej. Kontynuacja odbiera informacje o stanie dostarczone przez obiekt wywołujący i używa określonego harmonogramu.
ContinueWith<TResult>(Func<Task,TResult>)	Tworzy kontynuację, która wykonuje asynchronicznie po zakończeniu Task<TResult> docelowej i zwraca wartość.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)	Tworzy kontynuację, która wykonuje asynchronicznie po zakończeniu Task docelowej i zwraca wartość. Kontynuacja otrzymuje token anulowania.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Tworzy kontynuację wykonywaną zgodnie z określonymi opcjami kontynuacji i zwraca wartość. Kontynuacja jest przekazywana token anulowania i używa określonego harmonogramu.
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)	Tworzy kontynuację wykonywaną zgodnie z określonymi opcjami kontynuacji i zwraca wartość.
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler)	Tworzy kontynuację, która wykonuje asynchronicznie po zakończeniu Task docelowej i zwraca wartość. Kontynuacja używa określonego harmonogramu.
Delay(Int32)	Tworzy zadanie, które zostanie ukończone po określonej liczbie milisekund.
Delay(Int32, CancellationToken)	Tworzy zadanie, które można anulować, które zostanie ukończone po określonej liczbie milisekund.
Delay(TimeSpan)	Tworzy zadanie, które zostanie ukończone po określonym interwale czasu.
Delay(TimeSpan, CancellationToken)	Tworzy zadanie, które można anulować, które zostanie ukończone po określonym interwale czasu.
Delay(TimeSpan, TimeProvider)	Tworzy zadanie, które zostanie ukończone po określonym interwale czasu.
Delay(TimeSpan, TimeProvider, CancellationToken)	Tworzy zadanie, które można anulować, które zostanie ukończone po określonym interwale czasu.
Dispose()	Zwalnia wszystkie zasoby używane przez bieżące wystąpienie klasy Task.
Dispose(Boolean)	Usuwa Task, zwalniając wszystkie niezarządzane zasoby.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
FromCanceled(CancellationToken)	Tworzy Task, które zostały ukończone z powodu anulowania z określonym tokenem anulowania.
FromCanceled<TResult>(CancellationToken)	Tworzy Task<TResult>, które zostały ukończone z powodu anulowania z określonym tokenem anulowania.
FromException(Exception)	Tworzy Task, który został ukończony z określonym wyjątkiem.
FromException<TResult>(Exception)	Tworzy Task<TResult> zakończone z określonym wyjątkiem.
FromResult<TResult>(TResult)	Tworzy Task<TResult>, który został pomyślnie ukończony z określonym wynikiem.
GetAwaiter()	Pobiera element awaiter używany do oczekiwania na ten Task.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
Run(Action)	Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca obiekt Task, który reprezentuje to działanie.
Run(Action, CancellationToken)	Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca obiekt Task, który reprezentuje to działanie. Token anulowania umożliwia anulowanie pracy, jeśli jeszcze nie została uruchomiona.
Run(Func<Task>)	Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca serwer proxy dla zadania zwróconego przez function.
Run(Func<Task>, CancellationToken)	Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca serwer proxy dla zadania zwróconego przez function. Token anulowania umożliwia anulowanie pracy, jeśli jeszcze nie została uruchomiona.
Run<TResult>(Func<Task<TResult>>)	Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca serwer proxy dla Task(TResult) zwrócony przez function. Token anulowania umożliwia anulowanie pracy, jeśli jeszcze nie została uruchomiona.
Run<TResult>(Func<Task<TResult>>, CancellationToken)	Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca serwer proxy dla Task(TResult) zwrócony przez function.
Run<TResult>(Func<TResult>)	Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca obiekt Task<TResult>, który reprezentuje to działanie. Token anulowania umożliwia anulowanie pracy, jeśli jeszcze nie została uruchomiona.
Run<TResult>(Func<TResult>, CancellationToken)	Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca obiekt Task(TResult), który reprezentuje to działanie.
RunSynchronously()	Uruchamia Task synchronicznie w bieżącym TaskScheduler.
RunSynchronously(TaskScheduler)	Uruchamia Task synchronicznie w podanym TaskScheduler.
Start()	Uruchamia Task, planując jego wykonanie do bieżącego TaskScheduler.
Start(TaskScheduler)	Uruchamia Task, planując wykonanie do określonego TaskScheduler.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
Wait()	Czeka na ukończenie wykonywania Task.
Wait(CancellationToken)	Czeka na ukończenie wykonywania Task. Oczekiwanie kończy się, jeśli token anulowania zostanie anulowany przed ukończeniem zadania.
Wait(Int32)	Czeka na ukończenie wykonywania Task w ciągu określonej liczby milisekund.
Wait(Int32, CancellationToken)	Czeka na ukończenie wykonywania Task. Oczekiwanie kończy się, jeśli upłynie interwał limitu czasu lub token anulowania zostanie anulowany przed ukończeniem zadania.
Wait(TimeSpan)	Czeka na ukończenie wykonywania Task w określonym przedziale czasu.
Wait(TimeSpan, CancellationToken)	Czeka na ukończenie wykonywania Task.
WaitAll(Task[])	Czeka na ukończenie wykonywania wszystkich podanych obiektów Task.
WaitAll(Task[], CancellationToken)	Czeka na ukończenie wykonywania wszystkich podanych obiektów Task, chyba że oczekiwanie zostanie anulowane.
WaitAll(Task[], Int32)	Czeka na ukończenie wykonywania wszystkich podanych obiektów Task w określonej liczbie milisekund.
WaitAll(Task[], Int32, CancellationToken)	Czeka na ukończenie wykonywania wszystkich podanych obiektów Task w określonej liczbie milisekund lub do momentu anulowania oczekiwania.
WaitAll(Task[], TimeSpan)	Czeka na ukończenie wykonywania wszystkich dostępnych obiektów Task anulowanych w określonym przedziale czasu.
WaitAny(Task[])	Czeka na ukończenie wykonywania dowolnego z podanych obiektów Task.
WaitAny(Task[], CancellationToken)	Czeka na ukończenie wykonywania dowolnego z podanych obiektów Task, chyba że oczekiwanie zostanie anulowane.
WaitAny(Task[], Int32)	Czeka na ukończenie wykonywania dowolnego z podanych obiektów Task w określonej liczbie milisekund.
WaitAny(Task[], Int32, CancellationToken)	Czeka na ukończenie wykonywania dowolnego z podanych obiektów Task w określonej liczbie milisekund lub do momentu anulowania tokenu anulowania.
WaitAny(Task[], TimeSpan)	Czeka na wykonanie dowolnego z podanych obiektów Task w określonym przedziale czasu.
WaitAsync(CancellationToken)	Pobiera Task, które zostaną ukończone po zakończeniu tego Task lub gdy określony CancellationToken zażądał anulowania.
WaitAsync(TimeSpan)	Pobiera Task, które zostaną ukończone po zakończeniu tego Task lub upływie określonego limitu czasu.
WaitAsync(TimeSpan, CancellationToken)	Pobiera Task, które zostaną ukończone po zakończeniu tego Task, po upływie określonego limitu czasu lub żądaniu anulowania określonego CancellationToken.
WaitAsync(TimeSpan, TimeProvider)	Pobiera Task, które zostaną ukończone po zakończeniu tego Task lub upływie określonego limitu czasu.
WaitAsync(TimeSpan, TimeProvider, CancellationToken)	Pobiera Task, które zostaną ukończone po zakończeniu tego Task, po upływie określonego limitu czasu lub żądaniu anulowania określonego CancellationToken.
WhenAll(IEnumerable<Task>)	Tworzy zadanie, które zostanie ukończone po zakończeniu wszystkich obiektów Task w kolekcji wyliczalnej.
WhenAll(Task[])	Tworzy zadanie, które zostanie ukończone po zakończeniu wszystkich obiektów Task w tablicy.
WhenAll<TResult>(IEnumerable<Task<TResult>>)	Tworzy zadanie, które zostanie ukończone po zakończeniu wszystkich obiektów Task<TResult> w kolekcji wyliczalnej.
WhenAll<TResult>(Task<TResult>[])	Tworzy zadanie, które zostanie ukończone po zakończeniu wszystkich obiektów Task<TResult> w tablicy.
WhenAny(IEnumerable<Task>)	Tworzy zadanie, które zostanie wykonane po zakończeniu któregokolwiek z dostarczonych zadań.
WhenAny(Task, Task)	Tworzy zadanie, które zostanie wykonane po zakończeniu któregokolwiek z dostarczonych zadań.
WhenAny(Task[])	Tworzy zadanie, które zostanie wykonane po zakończeniu któregokolwiek z dostarczonych zadań.
WhenAny<TResult>(IEnumerable<Task<TResult>>)	Tworzy zadanie, które zostanie wykonane po zakończeniu któregokolwiek z dostarczonych zadań.
WhenAny<TResult>(Task<TResult>, Task<TResult>)	Tworzy zadanie, które zostanie wykonane po zakończeniu któregokolwiek z dostarczonych zadań.
WhenAny<TResult>(Task<TResult>[])	Tworzy zadanie, które zostanie wykonane po zakończeniu któregokolwiek z dostarczonych zadań.
Yield()	Tworzy oczekujące zadanie, które asynchronicznie zwraca bieżący kontekst w oczekiwanym czasie.

Jawne implementacje interfejsu

IAsyncResult.AsyncWaitHandle	Pobiera WaitHandle, których można użyć do oczekiwania na ukończenie zadania.
IAsyncResult.CompletedSynchronously	Pobiera wskazanie, czy operacja została ukończona synchronicznie.

Metody rozszerzania

WaitAsync(Task, TimeSpan, TimeProvider, CancellationToken)

Pobiera Task, które zostaną ukończone po zakończeniu tego Task, po upływie określonego limitu czasu lub żądaniu anulowania określonego CancellationToken.

Bezpieczeństwo wątkowe

Wszystkie elementy członkowskie Task, z wyjątkiem Dispose(), są bezpieczne wątkowo i mogą być używane z wielu wątków jednocześnie.

Zobacz też

• Task<TResult>
• biblioteki równoległej zadań (TPL)
• wzorzec asynchroniczny oparty na zadaniach (TAP) na platformie .NET: Wprowadzenie i omówienie
• programowanie asynchroniczne oparte na zadaniach
• przykłady programowania równoległego przy użyciu platform .NET Core i .NET Standard