Task Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje asynchronní operaci.
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
- Dědičnost
-
Task
- Odvozené
- Implementuje
Poznámky
Další informace o tomto rozhraní API najdete v tématu Doplňkové poznámky k rozhraní API pro úlohu.
Konstruktory
Task(Action) |
Inicializuje nový Task pomocí zadané akce. |
Task(Action, CancellationToken) |
Inicializuje novou Task pomocí zadané akce a CancellationToken. |
Task(Action, CancellationToken, TaskCreationOptions) |
Inicializuje nový Task pomocí zadaných akcí a možností vytvoření. |
Task(Action, TaskCreationOptions) |
Inicializuje nový Task pomocí zadaných akcí a možností vytvoření. |
Task(Action<Object>, Object) |
Inicializuje nový Task se zadanou akcí a stavem. |
Task(Action<Object>, Object, CancellationToken) |
Inicializuje nový Task pomocí zadané akce, stavu a CancellationToken. |
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions) |
Inicializuje nový Task pomocí zadané akce, stavu a možností. |
Task(Action<Object>, Object, TaskCreationOptions) |
Inicializuje nový Task pomocí zadané akce, stavu a možností. |
Vlastnosti
AsyncState |
Získá stav objektu zadaný při Task vytvoření nebo null, pokud nebyl zadán. |
CompletedTask |
Získá úkol, který již úspěšně dokončen. |
CreationOptions |
TaskCreationOptions Získá objekt použitý k vytvoření této úlohy. |
CurrentId |
Vrátí ID aktuálně spuštěného Taskobjektu . |
Exception |
Získá, AggregateException která způsobila Task předčasné ukončení. Pokud se Task operace úspěšně dokončila nebo ještě nevyvolá žádné výjimky, vrátí |
Factory |
Poskytuje přístup k metodám výroby pro vytváření a konfiguraci Task instancí a Task<TResult> . |
Id |
Získá ID pro tuto Task instanci. |
IsCanceled |
Získá, zda tato Task instance dokončil provádění z důvodu zrušení. |
IsCompleted |
Získá hodnotu, která označuje, zda úkol byl dokončen. |
IsCompletedSuccessfully |
Získá, zda úkol byl dokončen. |
IsFaulted |
Získá, zda Task dokončeno z důvodu neošetřené výjimky. |
Status |
Získá z TaskStatus tohoto úkolu. |
Metody
ConfigureAwait(Boolean) |
Konfiguruje operátor awaiter, který se používá k vyčkávanému objektu Task. |
ConfigureAwait(ConfigureAwaitOptions) |
Konfiguruje operátor awaiter, který se používá k vyčkávanému objektu Task. |
ContinueWith(Action<Task,Object>, Object) |
Vytvoří pokračování, které obdrží informace o stavu zadané volajícím a spustí se po dokončení cíle Task . |
ContinueWith(Action<Task,Object>, Object, CancellationToken) |
Vytvoří pokračování, které obdrží informace o stavu zadané volajícím a token zrušení a který se spustí asynchronně po dokončení cíle Task . |
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler) |
Vytvoří pokračování, které obdrží informace o stavu zadané volajícím a token zrušení a který se spustí po dokončení cíle Task . Pokračování se provádí na základě sady zadaných podmínek a používá zadaný plánovač. |
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions) |
Vytvoří pokračování, které obdrží informace o stavu zadané volajícím a spustí se po dokončení cíle Task . Pokračování se spustí na základě sady zadaných podmínek. |
ContinueWith(Action<Task,Object>, Object, TaskScheduler) |
Vytvoří pokračování, které obdrží informace o stavu zadané volajícím a provede asynchronně po dokončení cíle Task . Pokračování používá zadaný plánovač. |
ContinueWith(Action<Task>) |
Vytvoří pokračování, které se spustí asynchronně po dokončení cíle Task . |
ContinueWith(Action<Task>, CancellationToken) |
Vytvoří pokračování, které obdrží token zrušení a provede se asynchronně po dokončení cíle Task . |
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler) |
Vytvoří pokračování, které se spustí, když cílová úloha konkuruje podle zadaného TaskContinuationOptions. Pokračování obdrží token zrušení a použije zadaný plánovač. |
ContinueWith(Action<Task>, TaskContinuationOptions) |
Vytvoří pokračování, které se spustí po dokončení cílové úlohy podle zadaného TaskContinuationOptionsobjektu . |
ContinueWith(Action<Task>, TaskScheduler) |
Vytvoří pokračování, které se spustí asynchronně po dokončení cíle Task . Pokračování používá zadaný plánovač. |
ContinueWith<TResult>(Func<Task,Object,TResult>, Object) |
Vytvoří pokračování, které přijímá informace o stavu zadané volajícím a provádí asynchronně, když cíl Task dokončí a vrátí hodnotu. |
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken) |
Vytvoří pokračování, které se spustí asynchronně, když se cíl Task dokončí a vrátí hodnotu. Pokračování obdrží informace o stavu zadané volajícím a token zrušení. |
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler) |
Vytvoří pokračování, které se spustí na základě zadaných možností pokračování úkolu, když cíl Task dokončí a vrátí hodnotu. Pokračování obdrží informace o stavu zadané volajícím a token zrušení a použije zadaný plánovač. |
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskContinuationOptions) |
Vytvoří pokračování, které se spustí na základě zadaných možností pokračování úkolu po dokončení cíle Task . Pokračování obdrží informace o stavu zadané volajícím. |
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskScheduler) |
Vytvoří pokračování, které se spustí asynchronně po dokončení cíle Task . Pokračování obdrží informace o stavu zadané volajícím a používá zadaný plánovač. |
ContinueWith<TResult>(Func<Task,TResult>) |
Vytvoří pokračování, které se spustí asynchronně, když se cíl Task<TResult> dokončí a vrátí hodnotu. |
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken) |
Vytvoří pokračování, které se spustí asynchronně, když se cíl Task dokončí a vrátí hodnotu. Pokračování obdrží token zrušení. |
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler) |
Vytvoří pokračování, které se spustí podle zadaných možností pokračování a vrátí hodnotu. Pokračování se předá token zrušení a použije zadaný plánovač. |
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions) |
Vytvoří pokračování, které se spustí podle zadaných možností pokračování a vrátí hodnotu. |
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler) |
Vytvoří pokračování, které se spustí asynchronně, když se cíl Task dokončí a vrátí hodnotu. Pokračování používá zadaný plánovač. |
Delay(Int32) |
Vytvoří úlohu, která se dokončí po zadaném počtu milisekund. |
Delay(Int32, CancellationToken) |
Vytvoří zrušitelný úkol, který se dokončí po zadaném počtu milisekund. |
Delay(TimeSpan) |
Vytvoří úlohu, která se dokončí po zadaném časovém intervalu. |
Delay(TimeSpan, CancellationToken) |
Vytvoří zrušitelný úkol, který se dokončí po zadaném časovém intervalu. |
Delay(TimeSpan, TimeProvider) |
Vytvoří úlohu, která se dokončí po zadaném časovém intervalu. |
Delay(TimeSpan, TimeProvider, CancellationToken) |
Vytvoří zrušitelný úkol, který se dokončí po zadaném časovém intervalu. |
Dispose() |
Uvolní všechny prostředky používané aktuální instancí Task třídy . |
Dispose(Boolean) |
Odstraní a Taskuvolní všechny své nespravované prostředky. |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
FromCanceled(CancellationToken) |
Vytvoří dokončený Task kvůli zrušení se zadaným tokenem zrušení. |
FromCanceled<TResult>(CancellationToken) |
Vytvoří dokončený Task<TResult> kvůli zrušení se zadaným tokenem zrušení. |
FromException(Exception) |
Vytvoří , Task který byl dokončen se zadanou výjimkou. |
FromException<TResult>(Exception) |
Vytvoří dokončený Task<TResult> se zadanou výjimkou. |
FromResult<TResult>(TResult) |
Vytvoří úspěšně dokončený Task<TResult> se zadaným výsledkem. |
GetAwaiter() |
Získá operátor awaiter, který se použije k vyčkávacímu objektu Task. |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
Run(Action) |
Za frontu zadanou práci, která se má spustit ve fondu vláken, a vrátí objekt, který představuje danou Task práci. |
Run(Action, CancellationToken) |
Za frontu zadanou práci, která se má spustit ve fondu vláken, a vrátí objekt, který představuje danou Task práci. Token zrušení umožňuje zrušit práci, pokud ještě nezačala. |
Run(Func<Task>) |
Za frontu zadanou práci, která se má spustit ve fondu vláken, a vrátí proxy server pro úlohu vrácenou nástrojem |
Run(Func<Task>, CancellationToken) |
Za frontu zadanou práci, která se má spustit ve fondu vláken, a vrátí proxy server pro úlohu vrácenou nástrojem |
Run<TResult>(Func<Task<TResult>>) |
Za frontu zadanou práci, která se má spustit ve fondu vláken, a vrátí proxy server pro |
Run<TResult>(Func<Task<TResult>>, CancellationToken) |
Za frontu zadanou práci, která se má spustit ve fondu vláken, a vrátí proxy server pro |
Run<TResult>(Func<TResult>) |
Za frontu zadanou práci, která se má spustit ve fondu vláken, a vrátí objekt, který představuje danou Task<TResult> práci. Token zrušení umožňuje zrušit práci, pokud ještě nezačala. |
Run<TResult>(Func<TResult>, CancellationToken) |
Za frontu zadanou práci, která se má spustit ve fondu vláken, a vrátí objekt, který představuje danou |
RunSynchronously() |
Task Spouští synchronně na aktuálním TaskScheduler. |
RunSynchronously(TaskScheduler) |
Spustí synchronně Task na zadaném .TaskScheduler |
Start() |
TaskSpustí a naplánuje jeho spuštění na aktuální TaskScheduler. |
Start(TaskScheduler) |
TaskSpustí a naplánuje jeho spuštění na zadanou TaskSchedulerhodnotu . |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
Wait() |
Čeká na Task dokončení spuštění. |
Wait(CancellationToken) |
Čeká na Task dokončení spuštění. Čekání se ukončí, pokud je token zrušení zrušen před dokončením úlohy. |
Wait(Int32) |
Čeká na Task dokončení spuštění v zadaném počtu milisekund. |
Wait(Int32, CancellationToken) |
Čeká na Task dokončení spuštění. Čekání se ukončí, pokud uplynou interval časového limitu nebo se před dokončením úlohy zruší token zrušení. |
Wait(TimeSpan) |
Čeká na Task dokončení spuštění v zadaném časovém intervalu. |
Wait(TimeSpan, CancellationToken) |
Čeká na Task dokončení spuštění. |
WaitAll(IEnumerable<Task>, CancellationToken) |
Představuje asynchronní operaci. |
WaitAll(ReadOnlySpan<Task>) |
Představuje asynchronní operaci. |
WaitAll(Task[]) |
Čeká na dokončení provádění všech zadaných Task objektů. |
WaitAll(Task[], CancellationToken) |
Čeká na dokončení provádění všech zadaných Task objektů, pokud není čekání zrušeno. |
WaitAll(Task[], Int32) |
Čeká na dokončení provádění všech zadaných Task objektů v zadaném počtu milisekund. |
WaitAll(Task[], Int32, CancellationToken) |
Čeká na dokončení provádění všech zadaných Task objektů v zadaném počtu milisekund nebo do zrušení čekání. |
WaitAll(Task[], TimeSpan) |
Čeká na dokončení provádění všech zadaných zrušitelných Task objektů v zadaném časovém intervalu. |
WaitAny(Task[]) |
Počká na dokončení provádění některého ze zadaných Task objektů. |
WaitAny(Task[], CancellationToken) |
Čeká na provedení některého ze zadaných Task objektů, pokud není čekání zrušeno. |
WaitAny(Task[], Int32) |
Čeká na provedení některého z zadaných Task objektů v zadaném počtu milisekund. |
WaitAny(Task[], Int32, CancellationToken) |
Čeká na dokončení spuštění některého z poskytnutých Task objektů během zadaného počtu milisekund nebo do zrušení tokenu zrušení. |
WaitAny(Task[], TimeSpan) |
Čeká na dokončení spuštění některého z poskytnutých Task objektů v zadaném časovém intervalu. |
WaitAsync(CancellationToken) |
Task Získá, která bude dokončena po dokončení nebo Task když zadaný CancellationToken má požadavek na zrušení. |
WaitAsync(TimeSpan) |
Task Získá, která bude dokončena po dokončení nebo Task po vypršení zadaného časového limitu. |
WaitAsync(TimeSpan, CancellationToken) |
Task Získá, která bude dokončena po dokončení tétoTask, po vypršení zadaného časového limitu nebo když zadaný CancellationToken požadavek zrušení. |
WaitAsync(TimeSpan, TimeProvider) |
Task Získá, která bude dokončena po dokončení nebo Task po vypršení zadaného časového limitu. |
WaitAsync(TimeSpan, TimeProvider, CancellationToken) |
Task Získá, která bude dokončena po dokončení tétoTask, po vypršení zadaného časového limitu nebo když zadaný CancellationToken požadavek zrušení. |
WhenAll(IEnumerable<Task>) |
Vytvoří úlohu, která bude dokončena po dokončení všech Task objektů v výčtové kolekci. |
WhenAll(ReadOnlySpan<Task>) |
Představuje asynchronní operaci. |
WhenAll(Task[]) |
Vytvoří úlohu, která bude dokončena po dokončení všech Task objektů v poli. |
WhenAll<TResult>(IEnumerable<Task<TResult>>) |
Vytvoří úlohu, která bude dokončena po dokončení všech Task<TResult> objektů v výčtové kolekci. |
WhenAll<TResult>(ReadOnlySpan<Task<TResult>>) |
Představuje asynchronní operaci. |
WhenAll<TResult>(Task<TResult>[]) |
Vytvoří úlohu, která bude dokončena po dokončení všech Task<TResult> objektů v poli. |
WhenAny(IEnumerable<Task>) |
Vytvoří úlohu, která bude dokončena po dokončení některého z zadaných úkolů. |
WhenAny(ReadOnlySpan<Task>) |
Představuje asynchronní operaci. |
WhenAny(Task, Task) |
Vytvoří úlohu, která se dokončí po dokončení některého z zadaných úkolů. |
WhenAny(Task[]) |
Vytvoří úlohu, která bude dokončena po dokončení některého z zadaných úkolů. |
WhenAny<TResult>(IEnumerable<Task<TResult>>) |
Vytvoří úlohu, která bude dokončena po dokončení některého z zadaných úkolů. |
WhenAny<TResult>(ReadOnlySpan<Task<TResult>>) |
Představuje asynchronní operaci. |
WhenAny<TResult>(Task<TResult>, Task<TResult>) |
Vytvoří úlohu, která se dokončí po dokončení některého z zadaných úkolů. |
WhenAny<TResult>(Task<TResult>[]) |
Vytvoří úlohu, která bude dokončena po dokončení některého z zadaných úkolů. |
WhenEach(IEnumerable<Task>) |
Představuje asynchronní operaci. |
WhenEach(ReadOnlySpan<Task>) |
Představuje asynchronní operaci. |
WhenEach(Task[]) |
Představuje asynchronní operaci. |
WhenEach<TResult>(IEnumerable<Task<TResult>>) |
Představuje asynchronní operaci. |
WhenEach<TResult>(ReadOnlySpan<Task<TResult>>) |
Představuje asynchronní operaci. |
WhenEach<TResult>(Task<TResult>[]) |
Představuje asynchronní operaci. |
Yield() |
Vytvoří čekající úlohu, která asynchronně vrátí aktuální kontext při vyčká. |
Explicitní implementace rozhraní
IAsyncResult.AsyncWaitHandle |
WaitHandle Získá, který lze použít k čekání na dokončení úkolu. |
IAsyncResult.CompletedSynchronously |
Získá indikaci, zda operace dokončena synchronně. |
Metody rozšíření
AsyncWait<TException>(Task) |
Představuje asynchronní operaci. |
AwaitWithTimeout(Task, TimeSpan) |
Představuje asynchronní operaci. |
ToApm(Task, AsyncCallback, Object) |
Představuje asynchronní operaci. |
ToApmEnd(IAsyncResult) |
Představuje asynchronní operaci. |
ToApmEnd<TResult>(IAsyncResult) |
Představuje asynchronní operaci. |
Wait(Task, TimeSpan, Action<Exception,TimeSpan,String>, String) |
Představuje asynchronní operaci. |
WaitForCompletion(Task) |
Představuje asynchronní operaci. |
WaitForCompletionNoSpin(Task) |
Představuje asynchronní operaci. |
WaitForCompletionNoSpin(Task, TimeSpan) |
Představuje asynchronní operaci. |
WaitAsync(Task, TimeSpan, TimeProvider, CancellationToken) |
Představuje asynchronní operaci. |
DispatcherOperationWait(Task) |
Čeká neurčitou dobu na dokončení základního souboru DispatcherOperation . |
DispatcherOperationWait(Task, TimeSpan) |
Čeká na zadanou dobu, než se podklad dokončí DispatcherOperation . |
IsDispatcherOperationTask(Task) |
Vrátí hodnotu, která označuje, zda je přidružena Task k .DispatcherOperation |
AsAsyncAction(Task) |
Vrátí prostředí Windows Runtime asynchronní akci, která představuje spuštěnou úlohu. |
Platí pro
Bezpečný přístup z více vláken
Všechny členy , Tasks výjimkou , jsou bezpečné pro Dispose()přístup z více vláken a mohou být použity z více vláken současně.
Viz také
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro