Sdílet prostřednictvím


Task Třída

Definice

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 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(IEnumerable<Task>, CancellationToken)

Čeká na dokončení provádění všech zadaných objektů Task, pokud se čekání nezruší.

WaitAll(ReadOnlySpan<Task>)

Čeká na dokončení provádění všech zadaných objektů 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(ReadOnlySpan<Task>)

Vytvoří úkol, který se dokončí po dokončení všech zadaných úkolů.

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>(ReadOnlySpan<Task<TResult>>)

Vytvoří úkol, který se dokončí po dokončení všech zadaných úkolů.

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(ReadOnlySpan<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>(ReadOnlySpan<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ů.

WhenEach(IEnumerable<Task>)

Vytvoří IAsyncEnumerable<T>, který bude poskytovat zadané úkoly jako dokončené.

WhenEach(ReadOnlySpan<Task>)

Vytvoří IAsyncEnumerable<T>, který bude poskytovat zadané úkoly jako dokončené.

WhenEach(Task[])

Vytvoří IAsyncEnumerable<T>, který bude poskytovat zadané úkoly jako dokončené.

WhenEach<TResult>(IEnumerable<Task<TResult>>)

Vytvoří IAsyncEnumerable<T>, který bude poskytovat zadané úkoly jako dokončené.

WhenEach<TResult>(ReadOnlySpan<Task<TResult>>)

Vytvoří IAsyncEnumerable<T>, který bude poskytovat zadané úkoly jako dokončené.

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

Vytvoří IAsyncEnumerable<T>, který bude poskytovat zadané úkoly jako dokončené.

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í

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

DispatcherOperationWait(Task)

Čeká po neomezenou dobu, než se podkladová DispatcherOperation dokončí.

DispatcherOperationWait(Task, TimeSpan)

Čeká na dobu, po kterou se podkladová DispatcherOperation dokončí.

IsDispatcherOperationTask(Task)

Vrátí hodnotu, která určuje, zda je tato Task přidružena k DispatcherOperation.

AsAsyncAction(Task)

Vrátí asynchronní akci prostředí Windows Runtime, která představuje spuštěnou úlohu.

Platí pro

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é