Task Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 |
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 |
Run(Func<Task>, CancellationToken) |
Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca serwer proxy dla zadania zwróconego przez |
Run<TResult>(Func<Task<TResult>>) |
Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca serwer proxy dla |
Run<TResult>(Func<Task<TResult>>, CancellationToken) |
Kolejkuje określoną pracę do uruchomienia w puli wątków i zwraca serwer proxy dla |
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 |
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(IEnumerable<Task>, CancellationToken) |
Reprezentuje operację asynchroniczną. |
WaitAll(ReadOnlySpan<Task>) |
Reprezentuje operację asynchroniczną. |
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(ReadOnlySpan<Task>) |
Reprezentuje operację asynchroniczną. |
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>(ReadOnlySpan<Task<TResult>>) |
Reprezentuje operację asynchroniczną. |
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(ReadOnlySpan<Task>) |
Reprezentuje operację asynchroniczną. |
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>(ReadOnlySpan<Task<TResult>>) |
Reprezentuje operację asynchroniczną. |
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ń. |
WhenEach(IEnumerable<Task>) |
Reprezentuje operację asynchroniczną. |
WhenEach(ReadOnlySpan<Task>) |
Reprezentuje operację asynchroniczną. |
WhenEach(Task[]) |
Reprezentuje operację asynchroniczną. |
WhenEach<TResult>(IEnumerable<Task<TResult>>) |
Reprezentuje operację asynchroniczną. |
WhenEach<TResult>(ReadOnlySpan<Task<TResult>>) |
Reprezentuje operację asynchroniczną. |
WhenEach<TResult>(Task<TResult>[]) |
Reprezentuje operację asynchroniczną. |
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
AsyncWait<TException>(Task) |
Reprezentuje operację asynchroniczną. |
AwaitWithTimeout(Task, TimeSpan) |
Reprezentuje operację asynchroniczną. |
ToApm(Task, AsyncCallback, Object) |
Reprezentuje operację asynchroniczną. |
ToApmEnd(IAsyncResult) |
Reprezentuje operację asynchroniczną. |
ToApmEnd<TResult>(IAsyncResult) |
Reprezentuje operację asynchroniczną. |
Wait(Task, TimeSpan, Action<Exception,TimeSpan,String>, String) |
Reprezentuje operację asynchroniczną. |
WaitForCompletion(Task) |
Reprezentuje operację asynchroniczną. |
WaitForCompletionNoSpin(Task) |
Reprezentuje operację asynchroniczną. |
WaitForCompletionNoSpin(Task, TimeSpan) |
Reprezentuje operację asynchroniczną. |
WaitAsync(Task, TimeSpan, TimeProvider, CancellationToken) |
Reprezentuje operację asynchroniczną. |
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ż
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla