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 dodatkowe uwagi dotyczące interfejsu API dla zadania.

Konstruktory

Task(Action)

Inicjuje nową Task akcję przy użyciu określonej akcji.

Task(Action, CancellationToken)

Inicjuje nowy Task element z określoną akcją i CancellationToken.

Task(Action, CancellationToken, TaskCreationOptions)

Inicjuje nową Task z określoną akcją i opcjami tworzenia.

Task(Action, TaskCreationOptions)

Inicjuje nową Task z określoną akcją i opcjami tworzenia.

Task(Action<Object>, Object)

Inicjuje nową Task z określoną akcją i stanem.

Task(Action<Object>, Object, CancellationToken)

Inicjuje nową Task akcję, stan i CancellationToken.

Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)

Inicjuje nową Task akcję, stan i opcje.

Task(Action<Object>, Object, TaskCreationOptions)

Inicjuje nową Task akcję, stan i opcje.

Właściwości

AsyncState

Pobiera obiekt stanu podany podczas Task tworzenia lub null, jeśli nie podano żadnego.

CompletedTask

Pobiera zadanie, które zostało już ukończone pomyślnie.

CreationOptions

Pobiera element użyty do utworzenia TaskCreationOptions tego zadania.

CurrentId

Zwraca identyfikator aktualnie wykonywanego elementu Task.

Exception

AggregateException Pobiera to, co spowodowało Task zakończenie przedwcześnie. Task Jeśli ukończono pomyślnie lub nie zgłosił jeszcze żadnych wyjątków, zwróci to polecenie null.

Factory

Zapewnia dostęp do metod fabrycznych do tworzenia i konfigurowania Task wystąpień.Task<TResult>

Id

Pobiera identyfikator dla tego Task wystąpienia.

IsCanceled

Pobiera, czy to Task wystąpienie zakończyło wykonywanie 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 ukończono Task z powodu nieobsługiwanego wyjątku.

Status

TaskStatus Pobiera to zadanie.

Metody

ConfigureAwait(Boolean)

Konfiguruje program awaiter używany do oczekiwania na ten Taskelement .

ConfigureAwait(ConfigureAwaitOptions)

Konfiguruje program awaiter używany do oczekiwania na ten Taskelement .

ContinueWith(Action<Task,Object>, Object)

Tworzy kontynuację, która odbiera informacje o stanie dostarczonego przez obiekt wywołujący i wykonuje je po zakończeniu działania obiektu docelowego Task .

ContinueWith(Action<Task,Object>, Object, CancellationToken)

Tworzy kontynuację, która odbiera informacje o stanie dostarczonym przez obiekt wywołujący oraz token anulowania, który jest wykonywany asynchronicznie po zakończeniu działania obiektu docelowego Task .

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 działania obiektu docelowego Task . Kontynuacja jest wykonywana na podstawie zestawu określonych warunków i używa określonego harmonogramu.

ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions)

Tworzy kontynuację, która odbiera informacje o stanie dostarczonego przez obiekt wywołujący i wykonuje je po zakończeniu działania obiektu docelowego Task . 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 działania obiektu docelowego Task . Kontynuacja używa określonego harmonogramu.

ContinueWith(Action<Task>)

Tworzy kontynuację wykonywaną asynchronicznie po zakończeniu celu Task .

ContinueWith(Action<Task>, CancellationToken)

Tworzy kontynuację, która odbiera token anulowania i wykonuje asynchronicznie po zakończeniu elementu docelowego Task .

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 TaskContinuationOptionselementem .

ContinueWith(Action<Task>, TaskScheduler)

Tworzy kontynuację wykonywaną asynchronicznie po zakończeniu celu Task . Kontynuacja używa określonego harmonogramu.

ContinueWith<TResult>(Func<Task,Object,TResult>, Object)

Tworzy kontynuację, która odbiera informacje o stanie dostarczone przez obiekt wywołujący i wykonuje asynchronicznie, gdy element docelowy Task zakończy i zwróci wartość.

ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)

Tworzy kontynuację, która jest wykonywana asynchronicznie po zakończeniu obiektu docelowego Task 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ę, która jest wykonywana na podstawie określonych opcji kontynuacji zadania, gdy element docelowy Task zakończy działanie 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ę, która jest wykonywana na podstawie określonych opcji kontynuacji zadania po zakończeniu celu Task . 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 celu Task . 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 jest wykonywana asynchronicznie po zakończeniu obiektu docelowego Task<TResult> i zwraca wartość.

ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)

Tworzy kontynuację, która jest wykonywana asynchronicznie po zakończeniu obiektu docelowego Task 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 jest wykonywana asynchronicznie po zakończeniu obiektu docelowego Task i zwraca wartość. Kontynuacja używa określonego harmonogramu.

Delay(Int32)

Tworzy zadanie, które zostanie zakończone po określonej liczbie milisekund.

Delay(Int32, CancellationToken)

Tworzy zadanie, które można anulować, które zostanie zakoń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 element Task, zwalniając wszystkie niezarządzane zasoby.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
FromCanceled(CancellationToken)

Task Tworzy obiekt, który został ukończony z powodu anulowania z określonym tokenem anulowania.

FromCanceled<TResult>(CancellationToken)

Task<TResult> Tworzy obiekt, który został ukończony z powodu anulowania z określonym tokenem anulowania.

FromException(Exception)

Task Tworzy obiekt, który został ukończony z określonym wyjątkiem.

FromException<TResult>(Exception)

Task<TResult> Tworzy obiekt, który został ukończony z określonym wyjątkiem.

FromResult<TResult>(TResult)

Tworzy element Task<TResult> , który został pomyślnie ukończony z określonym wynikiem.

GetAwaiter()

Pobiera oczekiwany element służący do oczekiwania na ten Taskelement .

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
Run(Action)

Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca Task obiekt, który reprezentuje pracę.

Run(Action, CancellationToken)

Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca Task obiekt, który reprezentuje pracę. 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) zwracanego 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) zwracanego przez function.

Run<TResult>(Func<TResult>)

Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca Task<TResult> obiekt, który reprezentuje pracę. 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 Task(TResult) obiekt, który reprezentuje pracę.

RunSynchronously()

Task Uruchamia synchronicznie w bieżącym obiekcie TaskScheduler.

RunSynchronously(TaskScheduler)

Task Uruchamia synchronicznie podany TaskScheduler element.

Start()

Uruchamia element Task, planując wykonanie do bieżącego TaskSchedulerelementu .

Start(TaskScheduler)

Uruchamia obiekt Task, planując wykonanie do określonego TaskSchedulerelementu .

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
Wait()

Czeka na Task ukończenie wykonywania.

Wait(CancellationToken)

Czeka na Task zakończenie wykonywania. Oczekiwanie kończy się, jeśli token anulowania zostanie anulowany przed ukończeniem zadania.

Wait(Int32)

Czeka na Task ukończenie wykonywania w ciągu określonej liczby milisekund.

Wait(Int32, CancellationToken)

Czeka na Task zakończenie wykonywania. Oczekiwanie kończy się, jeśli upłynie interwał limitu czasu lub token anulowania zostanie anulowany przed zakończeniem zadania.

Wait(TimeSpan)

Oczekuje na Task ukończenie wykonywania w określonym przedziale czasu.

Wait(TimeSpan, CancellationToken)

Czeka na Task zakończenie wykonywania.

WaitAll(Task[])

Czeka na ukończenie wykonywania wszystkich podanych Task obiektów.

WaitAll(Task[], CancellationToken)

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

WaitAll(Task[], Int32)

Czeka na ukończenie wykonywania wszystkich podanych Task obiektów w ciągu określonej liczby milisekund.

WaitAll(Task[], Int32, CancellationToken)

Czeka na ukończenie wykonywania wszystkich podanych Task obiektów w ciągu określonej liczby milisekund lub do momentu anulowania oczekiwania.

WaitAll(Task[], TimeSpan)

Czeka na ukończenie wykonywania wszystkich udostępnionych obiektów, które można Task anulować w określonym przedziale czasu.

WaitAny(Task[])

Czeka na ukończenie wykonywania dowolnego z podanych Task obiektów.

WaitAny(Task[], CancellationToken)

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

WaitAny(Task[], Int32)

Czeka na ukończenie wykonywania dowolnego z podanych Task obiektów w ciągu określonej liczby milisekund.

WaitAny(Task[], Int32, CancellationToken)

Czeka na ukończenie wykonywania dowolnego z podanych Task obiektów w ciągu określonej liczby milisekund lub do momentu anulowania tokenu anulowania.

WaitAny(Task[], TimeSpan)

Czeka na ukończenie wykonywania dowolnego z podanych Task obiektów w określonym przedziale czasu.

WaitAsync(CancellationToken)

Pobiera element Task , który zostanie ukończony po Task zakończeniu lub po żądaniu anulowania określonego CancellationToken .

WaitAsync(TimeSpan)

Pobiera element Task , który zostanie ukończony po Task zakończeniu lub upływie określonego limitu czasu.

WaitAsync(TimeSpan, CancellationToken)

Pobiera element Task , który zostanie ukończony po Task zakończeniu, upływie określonego limitu czasu lub po żądaniu anulowania określonego CancellationToken limitu czasu.

WaitAsync(TimeSpan, TimeProvider)

Pobiera element Task , który zostanie ukończony po Task zakończeniu lub upływie określonego limitu czasu.

WaitAsync(TimeSpan, TimeProvider, CancellationToken)

Pobiera element Task , który zostanie ukończony po Task zakończeniu, upływie określonego limitu czasu lub po żądaniu anulowania określonego CancellationToken limitu czasu.

WhenAll(IEnumerable<Task>)

Tworzy zadanie, które zostanie ukończone po zakończeniu Task wszystkich obiektów w kolekcji wyliczalnej.

WhenAll(Task[])

Tworzy zadanie, które zostanie ukończone po zakończeniu Task wszystkich obiektów w tablicy.

WhenAll<TResult>(IEnumerable<Task<TResult>>)

Tworzy zadanie, które zostanie ukończone po zakończeniu Task<TResult> wszystkich obiektów w kolekcji wyliczalnej.

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

Tworzy zadanie, które zostanie ukończone po zakończeniu Task<TResult> wszystkich obiektów w tablicy.

WhenAny(IEnumerable<Task>)

Tworzy zadanie, które zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań.

WhenAny(Task, Task)

Tworzy zadanie, które zostanie ukończone po zakończeniu jednego z podanych zadań.

WhenAny(Task[])

Tworzy zadanie, które zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań.

WhenAny<TResult>(IEnumerable<Task<TResult>>)

Tworzy zadanie, które zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań.

WhenAny<TResult>(Task<TResult>, Task<TResult>)

Tworzy zadanie, które zostanie ukończone po zakończeniu jednego z podanych zadań.

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

Tworzy zadanie, które zostanie ukończone 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 element WaitHandle , który może służyć do oczekiwania na ukończenie zadania.

IAsyncResult.CompletedSynchronously

Pobiera wskazanie, czy operacja została ukończona synchronicznie.

Metody rozszerzania

DispatcherOperationWait(Task)

Czas oczekiwania na ukończenie bazowego DispatcherOperation .

DispatcherOperationWait(Task, TimeSpan)

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

IsDispatcherOperationTask(Task)

Zwraca wartość wskazującą, czy jest to Task skojarzone z elementem DispatcherOperation.

AsAsyncAction(Task)

Zwraca akcję asynchroniczną środowisko wykonawcze systemu Windows reprezentującą uruchomione zadanie.

Dotyczy

Bezpieczeństwo wątkowe

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

Zobacz też