Udostępnij za pośrednictwem


Task Klasa

Definicja

Reprezentuje operację asynchroniczną.

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
Dziedziczenie
Task
Pochodne
Implementuje

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(IEnumerable<Task>, CancellationToken)

Czeka na ukończenie wykonywania wszystkich podanych obiektów Task, chyba że oczekiwanie zostanie anulowane.

WaitAll(ReadOnlySpan<Task>)

Czeka na ukończenie wykonywania wszystkich podanych obiektów 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(ReadOnlySpan<Task>)

Tworzy zadanie, które zostanie wykonane po zakończeniu wszystkich dostarczonych zadań.

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>(ReadOnlySpan<Task<TResult>>)

Tworzy zadanie, które zostanie wykonane po zakończeniu wszystkich dostarczonych zadań.

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(ReadOnlySpan<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>(ReadOnlySpan<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ń.

WhenEach(IEnumerable<Task>)

Tworzy IAsyncEnumerable<T>, które będą zwracać dostarczone zadania w miarę wykonywania tych zadań.

WhenEach(ReadOnlySpan<Task>)

Tworzy IAsyncEnumerable<T>, które będą zwracać dostarczone zadania w miarę wykonywania tych zadań.

WhenEach(Task[])

Tworzy IAsyncEnumerable<T>, które będą zwracać dostarczone zadania w miarę wykonywania tych zadań.

WhenEach<TResult>(IEnumerable<Task<TResult>>)

Tworzy IAsyncEnumerable<T>, które będą zwracać dostarczone zadania w miarę wykonywania tych zadań.

WhenEach<TResult>(ReadOnlySpan<Task<TResult>>)

Tworzy IAsyncEnumerable<T>, które będą zwracać dostarczone zadania w miarę wykonywania tych zadań.

WhenEach<TResult>(Task<TResult>[])

Tworzy IAsyncEnumerable<T>, które będą zwracać dostarczone zadania w miarę wykonywania tych 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.

DispatcherOperationWait(Task)

Czeka na ukończenie bazowego DispatcherOperation przez czas nieokreślony.

DispatcherOperationWait(Task, TimeSpan)

Czeka na określoną ilość czasu na ukończenie bazowego DispatcherOperation.

IsDispatcherOperationTask(Task)

Zwraca wartość wskazującą, czy ta Task jest skojarzona z DispatcherOperation.

AsAsyncAction(Task)

Zwraca akcję asynchroniczną środowiska uruchomieniowego systemu Windows reprezentującą uruchomione zadanie.

Dotyczy

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ż