Task Třída

Definice

Obor názvů:

System.Threading.Tasks

Sestavení:

System.Runtime.dll

Source:

Task.cs

Představuje asynchronní operaci.

public ref class Task : IAsyncResult, IDisposable

public class Task : IAsyncResult, IDisposable

type Task = class
    interface IAsyncResult
    interface IDisposable

Public Class Task
Implements IAsyncResult, IDisposable

Dědičnost

Object

Task

Odvozené

System.Threading.Tasks.Task<TResult>

Implementuje

IAsyncResult IDisposable

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í nullse .
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 function.
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 function. Token zrušení umožňuje zrušit práci, pokud ještě nezačala.
Run<TResult>(Func<Task<TResult>>)	Za frontu zadanou práci, která se má spustit ve fondu vláken, a vrátí proxy server pro Task(TResult) práci vrácenou nástrojem function. Token zrušení umožňuje zrušit práci, pokud ještě nezačala.
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 Task(TResult) práci vrácenou nástrojem function.
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 Task(TResult) práci.
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(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(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>(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(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>(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ů.
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í

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é

• Task<TResult>
• Task Parallel Library (TPL)
• Asynchronní vzor založený na úlohách (TAP) v .NET: Úvod a přehled
• Asynchronní programování založené na úlohách
• Ukázky paralelního programování s .NET Core a .NET Standard