Task Třída

Definice

Obor názvů:

System.Threading.Tasks

Sestavení:

System.Runtime.dll

Zdroj:

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 naleznete v tématu doplňkové poznámky k rozhraní API proúloh .

Konstruktory

Task(Action)	Inicializuje nový Task se zadanou akcí.
Task(Action, CancellationToken)	Inicializuje nový Task se zadanou akcí a CancellationToken.
Task(Action, CancellationToken, TaskCreationOptions)	Inicializuje novou Task se zadanou akcí a možnostmi vytvoření.
Task(Action, TaskCreationOptions)	Inicializuje novou Task se zadanou akcí a možnostmi vytvoření.
Task(Action<Object>, Object)	Inicializuje nový Task se zadanou akcí a stavem.
Task(Action<Object>, Object, CancellationToken)	Inicializuje nový Task se zadanou akcí, stavem a CancellationToken.
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)	Inicializuje nový Task se zadanou akcí, stavem a možnostmi.
Task(Action<Object>, Object, TaskCreationOptions)	Inicializuje nový Task se zadanou akcí, stavem a možnostmi.

Vlastnosti

AsyncState	Získá stav objekt zadaný při vytvoření Task nebo null pokud nebyla zadána.
CompletedTask	Získá úkol, který již byl úspěšně dokončen.
CreationOptions	Získá TaskCreationOptions použitý k vytvoření této úlohy.
CurrentId	Vrátí ID aktuálně spuštěného Task.
Exception	Získá AggregateException, která způsobila Task předčasně ukončit. Pokud se Task úspěšně dokončil nebo ještě nevyvolá žádné výjimky, vrátí se null.
Factory	Poskytuje přístup k metodám továrny pro vytváření a konfiguraci Task a Task<TResult> instancí.
Id	Získá ID pro tuto instanci Task.
IsCanceled	Získá, zda tato Task instance dokončila 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 běžel na dokončení.
IsFaulted	Získá, zda Task dokončena kvůli neošetřené výjimce.
Status	Získá TaskStatus tohoto úkolu.

Metody

ConfigureAwait(Boolean)	Konfiguruje awaiter, který se používá k vyčkání tohoto Task.
ConfigureAwait(ConfigureAwaitOptions)	Konfiguruje awaiter, který se používá k vyčkání tohoto 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ílového Task.
ContinueWith(Action<Task,Object>, Object, CancellationToken)	Vytvoří pokračování, které přijímá informace o stavu zadané volajícím a token zrušení a který se spustí asynchronně po dokončení cílového Task.
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Vytvoří pokračování, které přijímá informace o stavu zadané volajícím a token zrušení a který se spustí po dokončení cílového Task. Pokračování se provede na základě sady zadaných podmínek a použije 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ílového Task. Pokračování se provede 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 spustí se asynchronně po dokončení cílového Task. Pokračování používá zadaný plánovač.
ContinueWith(Action<Task>)	Vytvoří pokračování, které se provede asynchronně po dokončení cílového Task.
ContinueWith(Action<Task>, CancellationToken)	Vytvoří pokračování, které přijímá token zrušení asynchronně po dokončení cílového Task.
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Vytvoří pokračování, které se provede, když cílová úloha konkuruje podle zadané 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í při dokončení cílové úlohy podle zadané TaskContinuationOptions.
ContinueWith(Action<Task>, TaskScheduler)	Vytvoří pokračování, které se provede asynchronně po dokončení cílového 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 spustí se asynchronně, když cíl Task dokončí a vrátí hodnotu.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)	Vytvoří pokračování, které se provede asynchronně, když 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í přijímá informace o stavu zadaném volajícím a token zrušení a používá 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ílového 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 provede asynchronně po dokončení cílového Task. Pokračování přijímá informace o stavu zadané volajícím a používá zadaný plánovač.
ContinueWith<TResult>(Func<Task,TResult>)	Vytvoří pokračování, které se provede asynchronně, když cíl Task<TResult> dokončí a vrátí hodnotu.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)	Vytvoří pokračování, které se provede asynchronně, když 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 provede podle zadaných možností pokračování a vrátí hodnotu. Pokračování se předává token zrušení a používá zadaný plánovač.
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)	Vytvoří pokračování, které se provede podle zadaných možností pokračování a vrátí hodnotu.
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler)	Vytvoří pokračování, které se provede asynchronně, když 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šený ú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šený ú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šený úkol, který se dokončí po zadaném časovém intervalu.
Dispose()	Uvolní všechny prostředky používané aktuální instancí třídy Task.
Dispose(Boolean)	Odstraní Task, uvolní všechny jeho nespravované prostředky.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
FromCanceled(CancellationToken)	Vytvoří Task, která se dokončí kvůli zrušení se zadaným tokenem zrušení.
FromCanceled<TResult>(CancellationToken)	Vytvoří Task<TResult>, která se dokončí kvůli zrušení se zadaným tokenem zrušení.
FromException(Exception)	Vytvoří Task, která byla dokončena se zadanou výjimkou.
FromException<TResult>(Exception)	Vytvoří Task<TResult>, která se dokončí se zadanou výjimkou.
FromResult<TResult>(TResult)	Vytvoří Task<TResult>, která se úspěšně dokončila se zadaným výsledkem.
GetAwaiter()	Získá awaiter, který se používá k čekací Task.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Run(Action)	Zařadí zadanou práci pro spuštění ve fondu vláken a vrátí Task objekt, který představuje danou práci.
Run(Action, CancellationToken)	Zařadí zadanou práci pro spuštění ve fondu vláken a vrátí Task objekt, který představuje danou práci. Token zrušení umožňuje zrušit práci, pokud ještě nebyla spuštěna.
Run(Func<Task>)	Zařadí zadanou práci pro spuštění ve fondu vláken a vrátí proxy server pro úlohu vrácenou function.
Run(Func<Task>, CancellationToken)	Zařadí zadanou práci pro spuštění ve fondu vláken a vrátí proxy server pro úlohu vrácenou function. Token zrušení umožňuje zrušit práci, pokud ještě nebyla spuštěna.
Run<TResult>(Func<Task<TResult>>)	Zařadí zadanou práci pro spuštění ve fondu vláken a vrátí proxy server pro Task(TResult) vrácenou function. Token zrušení umožňuje zrušit práci, pokud ještě nebyla spuštěna.
Run<TResult>(Func<Task<TResult>>, CancellationToken)	Zařadí zadanou práci pro spuštění ve fondu vláken a vrátí proxy server pro Task(TResult) vrácenou function.
Run<TResult>(Func<TResult>)	Zařadí zadanou práci pro spuštění ve fondu vláken a vrátí Task<TResult> objekt, který představuje danou práci. Token zrušení umožňuje zrušit práci, pokud ještě nebyla spuštěna.
Run<TResult>(Func<TResult>, CancellationToken)	Zařadí zadanou práci pro spuštění ve fondu vláken a vrátí Task(TResult) objekt, který představuje danou práci.
RunSynchronously()	Spustí Task synchronně na aktuální TaskScheduler.
RunSynchronously(TaskScheduler)	Spustí Task synchronně na zadaném TaskScheduler.
Start()	Spustí Task, naplánování spuštění na aktuální TaskScheduler.
Start(TaskScheduler)	Spustí Task, plánování spuštění do zadané TaskScheduler.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
Wait()	Čeká na dokončení provádění Task.
Wait(CancellationToken)	Čeká na dokončení provádění Task. Čekání se ukončí, pokud se před dokončením úlohy zruší token zrušení.
Wait(Int32)	Čeká na dokončení provádění Task v zadaném počtu milisekund.
Wait(Int32, CancellationToken)	Čeká na dokončení provádění Task. Čekání se ukončí, pokud se před dokončením úkolu zruší časový limit nebo se zruší token zrušení.
Wait(TimeSpan)	Čeká na dokončení provádění Task v zadaném časovém intervalu.
Wait(TimeSpan, CancellationToken)	Čeká na dokončení provádění Task.
WaitAll(Task[])	Čeká na dokončení provádění všech zadaných objektů Task.
WaitAll(Task[], CancellationToken)	Čeká na dokončení provádění všech zadaných objektů Task, pokud se čekání nezruší.
WaitAll(Task[], Int32)	Čeká na dokončení provádění všech zadaných objektů Task v zadaném počtu milisekund.
WaitAll(Task[], Int32, CancellationToken)	Čeká na dokončení provádění všech zadaných objektů Task 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šených Task objektů v zadaném časovém intervalu.
WaitAny(Task[])	Čeká na dokončení provádění některého z poskytnutých Task objektů.
WaitAny(Task[], CancellationToken)	Čeká na dokončení provádění některého z poskytnutých Task objektů, pokud se čekání nezruší.
WaitAny(Task[], Int32)	Čeká na dokončení provádění některého z poskytnutých Task objektů v zadaném počtu milisekund.
WaitAny(Task[], Int32, CancellationToken)	Čeká na dokončení provádění některého z poskytnutých Task objektů v zadaném počtu milisekund nebo do zrušení tokenu zrušení.
WaitAny(Task[], TimeSpan)	Čeká na dokončení provádění některého z poskytnutých Task objektů v zadaném časovém intervalu.
WaitAsync(CancellationToken)	Získá Task, který se dokončí po dokončení tohoto Task nebo po vyžádání zadaného CancellationToken zrušení.
WaitAsync(TimeSpan)	Získá Task, který se dokončí po dokončení tohoto Task nebo po vypršení zadaného časového limitu.
WaitAsync(TimeSpan, CancellationToken)	Získá Task, který se dokončí po dokončení tohoto Task, po vypršení zadaného časového limitu nebo když zadaný CancellationToken požádá o zrušení.
WaitAsync(TimeSpan, TimeProvider)	Získá Task, který se dokončí po dokončení tohoto Task nebo po vypršení zadaného časového limitu.
WaitAsync(TimeSpan, TimeProvider, CancellationToken)	Získá Task, který se dokončí po dokončení tohoto Task, po vypršení zadaného časového limitu nebo když zadaný CancellationToken požádá o zrušení.
WhenAll(IEnumerable<Task>)	Vytvoří úlohu, která se dokončí, když se dokončí všechny Task objekty v výčtové kolekci.
WhenAll(Task[])	Vytvoří úlohu, která se dokončí, když se dokončí všechny Task objekty v poli.
WhenAll<TResult>(IEnumerable<Task<TResult>>)	Vytvoří úlohu, která se dokončí, když se dokončí všechny Task<TResult> objekty v výčtové kolekci.
WhenAll<TResult>(Task<TResult>[])	Vytvoří úlohu, která se dokončí, když se dokončí všechny Task<TResult> objekty v poli.
WhenAny(IEnumerable<Task>)	Vytvoří úkol, který se dokončí po dokončení některého z zadaných úkolů.
WhenAny(Task, Task)	Vytvoří úkol, který se dokončí po dokončení některého z zadaných úkolů.
WhenAny(Task[])	Vytvoří úkol, který se dokončí po dokončení některého z zadaných úkolů.
WhenAny<TResult>(IEnumerable<Task<TResult>>)	Vytvoří úkol, který se dokončí po dokončení některého z zadaných úkolů.
WhenAny<TResult>(Task<TResult>, Task<TResult>)	Vytvoří úkol, který se dokončí po dokončení některého z zadaných úkolů.
WhenAny<TResult>(Task<TResult>[])	Vytvoří úkol, který se dokončí po dokončení některého z zadaných úkolů.
Yield()	Vytvoří čekající úlohu, která asynchronně vrátí aktuální kontext, když se čeká.

Explicitní implementace rozhraní

IAsyncResult.AsyncWaitHandle	Získá WaitHandle, který lze použít k čekání na dokončení úkolu.
IAsyncResult.CompletedSynchronously	Získá indikaci, zda operace byla 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)	Získá Task, který se dokončí po dokončení tohoto Task, po vypršení zadaného časového limitu nebo když zadaný CancellationToken požádá o zrušení.

Bezpečný přístup z více vláken

Všechny členy Tasks výjimkou Dispose()jsou bezpečné pro přístup z více vláken a mohou být použity současně z více vláken.

Viz také

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