Task Classe

Definizione

Spazio dei nomi:
System.Threading.Tasks
Assembly:
mscorlib.dll, System.Threading.Tasks.dll
Assembly:
netstandard.dll, System.Runtime.dll
Assembly:
System.Threading.Tasks.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origine:
Task.cs
Origine:
Task.cs
Origine:
Task.cs
Origine:
Task.cs
Origine:
Task.cs

Rappresenta un'operazione asincrona.

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
Ereditarietà
Object
Task
Derivato
Implementazioni
IAsyncResult IDisposable

Commenti

Per altre informazioni su questa API, vedere Osservazioni aggiuntive sull'API per attività.

Costruttori

Nome Descrizione
Task(Action, CancellationToken, TaskCreationOptions)

Inizializza un nuovo Task oggetto con le opzioni di creazione e azione specificate.
Task(Action, CancellationToken)

Inizializza un nuovo Task oggetto con l'azione specificata e CancellationToken.
Task(Action, TaskCreationOptions)

Inizializza un nuovo Task oggetto con le opzioni di creazione e azione specificate.
Task(Action)

Inizializza un nuovo Task oggetto con l'azione specificata.
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)

Inizializza un nuovo Task oggetto con l'azione, lo stato e le opzioni specificati.
Task(Action<Object>, Object, CancellationToken)

Inizializza un nuovo Task oggetto con l'azione, lo stato e l'oggetto CancellationTokenspecificati.
Task(Action<Object>, Object, TaskCreationOptions)

Inizializza un nuovo Task oggetto con l'azione, lo stato e le opzioni specificati.
Task(Action<Object>, Object)

Inizializza un nuovo Task oggetto con l'azione e lo stato specificati.

Proprietà

Nome Descrizione
AsyncState

Ottiene l'oggetto di stato fornito quando Task è stato creato o null se non è stato specificato alcun oggetto.
CompletedTask

Ottiene un'attività che è già stata completata correttamente.
CreationOptions

Ottiene l'oggetto TaskCreationOptions utilizzato per creare questa attività.
CurrentId

Restituisce l'ID dell'oggetto attualmente in esecuzione Task.
Exception

Ottiene l'oggetto AggregateException che ha causato la fine prematura dell'oggetto Task . Se l'oggetto Task completato correttamente o non ha ancora generato eccezioni, verrà restituito null.
Factory

Fornisce l'accesso ai metodi factory per la creazione e la Task configurazione di istanze e Task<TResult> .
Id

Ottiene un ID per questa Task istanza.
IsCanceled

Ottiene un valore che indica se l'esecuzione Task dell'istanza è stata completata a causa dell'annullamento.
IsCompleted

Ottiene un valore che indica se l'attività è stata completata.
IsCompletedSuccessfully

Ottiene un valore che indica se l'attività è stata eseguita fino al completamento.
IsFaulted

Ottiene un valore che indica se l'oggetto è stato completato a causa di un'eccezione Task non gestita.
Status

Ottiene l'oggetto TaskStatus di questa attività.

Metodi

Nome Descrizione
ConfigureAwait(Boolean)

Configura un awaiter usato per attendere questo Taskoggetto .
ConfigureAwait(ConfigureAwaitOptions)

Configura un awaiter usato per attendere questo Taskoggetto .
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Crea una continuazione che riceve informazioni sullo stato fornite dal chiamante e un token di annullamento che viene eseguito al termine della destinazione Task . La continuazione viene eseguita in base a un set di condizioni specificate e usa un'utilità di pianificazione specificata.
ContinueWith(Action<Task,Object>, Object, CancellationToken)

Crea una continuazione che riceve informazioni sullo stato fornite dal chiamante e un token di annullamento che viene eseguito in modo asincrono al termine della destinazione Task .
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions)

Crea una continuazione che riceve informazioni sullo stato fornite dal chiamante e viene eseguita al termine della destinazione Task . La continuazione viene eseguita in base a un set di condizioni specificate.
ContinueWith(Action<Task,Object>, Object, TaskScheduler)

Crea una continuazione che riceve informazioni sullo stato fornite dal chiamante e viene eseguita in modo asincrono al termine della destinazione Task . La continuazione usa un'utilità di pianificazione specificata.
ContinueWith(Action<Task,Object>, Object)

Crea una continuazione che riceve informazioni sullo stato fornite dal chiamante e viene eseguita al termine della destinazione Task .
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Crea una continuazione che viene eseguita quando l'attività di destinazione compete in base all'oggetto specificato TaskContinuationOptions. La continuazione riceve un token di annullamento e usa un'utilità di pianificazione specificata.
ContinueWith(Action<Task>, CancellationToken)

Crea una continuazione che riceve un token di annullamento ed esegue in modo asincrono al termine della destinazione Task .
ContinueWith(Action<Task>, TaskContinuationOptions)

Crea una continuazione che viene eseguita quando l'attività di destinazione viene completata in base all'oggetto specificato TaskContinuationOptions.
ContinueWith(Action<Task>, TaskScheduler)

Crea una continuazione che viene eseguita in modo asincrono al termine della destinazione Task . La continuazione usa un'utilità di pianificazione specificata.
ContinueWith(Action<Task>)

Crea una continuazione che viene eseguita in modo asincrono al termine della destinazione Task .
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Crea una continuazione eseguita in base alle opzioni di continuazione dell'attività specificate al termine della destinazione Task e restituisce un valore. La continuazione riceve informazioni sullo stato fornite dal chiamante e un token di annullamento e usa l'utilità di pianificazione specificata.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)

Crea una continuazione che viene eseguita in modo asincrono al termine della destinazione Task e restituisce un valore. La continuazione riceve informazioni sullo stato fornite dal chiamante e un token di annullamento.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskContinuationOptions)

Crea una continuazione che viene eseguita in base alle opzioni di continuazione dell'attività specificate al termine della destinazione Task . La continuazione riceve informazioni sullo stato fornite dal chiamante.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskScheduler)

Crea una continuazione che viene eseguita in modo asincrono al termine della destinazione Task . La continuazione riceve informazioni sullo stato fornite dal chiamante e usa un'utilità di pianificazione specificata.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object)

Crea una continuazione che riceve informazioni sullo stato fornite dal chiamante e viene eseguita in modo asincrono al termine della destinazione Task e restituisce un valore.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Crea una continuazione eseguita in base alle opzioni di continuazione specificate e restituisce un valore. La continuazione viene passata a un token di annullamento e usa un'utilità di pianificazione specificata.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)

Crea una continuazione che viene eseguita in modo asincrono al termine della destinazione Task e restituisce un valore. La continuazione riceve un token di annullamento.
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)

Crea una continuazione eseguita in base alle opzioni di continuazione specificate e restituisce un valore.
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler)

Crea una continuazione che viene eseguita in modo asincrono al termine della destinazione Task e restituisce un valore. La continuazione usa un'utilità di pianificazione specificata.
ContinueWith<TResult>(Func<Task,TResult>)

Crea una continuazione che viene eseguita in modo asincrono al termine della destinazione Task<TResult> e restituisce un valore.
Delay(Int32, CancellationToken)

Crea un'attività annullabile che viene completata dopo un numero specificato di millisecondi.
Delay(Int32)

Crea un'attività che viene completata dopo un numero specificato di millisecondi.
Delay(TimeSpan, CancellationToken)

Crea un'attività annullabile che viene completata dopo un intervallo di tempo specificato.
Delay(TimeSpan, TimeProvider, CancellationToken)

Crea un'attività annullabile che viene completata dopo un intervallo di tempo specificato.
Delay(TimeSpan, TimeProvider)

Crea un'attività che viene completata dopo un intervallo di tempo specificato.
Delay(TimeSpan)

Crea un'attività che viene completata dopo un intervallo di tempo specificato.
Dispose()

Rilascia tutte le risorse usate dall'istanza corrente della Task classe .
Dispose(Boolean)

Elimina , Taskrilasciando tutte le risorse non gestite.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
FromCanceled(CancellationToken)

Crea un oggetto Task completato a causa dell'annullamento con un token di annullamento specificato.
FromCanceled<TResult>(CancellationToken)

Crea un oggetto Task<TResult> completato a causa dell'annullamento con un token di annullamento specificato.
FromException(Exception)

Crea un oggetto Task completato con un'eccezione specificata.
FromException<TResult>(Exception)

Crea un Task<TResult> oggetto completato con un'eccezione specificata.
FromResult<TResult>(TResult)

Crea un Task<TResult> oggetto completato correttamente con il risultato specificato.
GetAwaiter()

Ottiene un awaiter utilizzato per attendere questo Taskoggetto .
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
Run(Action, CancellationToken)

Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un Task oggetto che rappresenta tale lavoro. Un token di annullamento consente di annullare il lavoro se non è ancora stato avviato.
Run(Action)

Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un Task oggetto che rappresenta tale lavoro.
Run(Func<Task>, CancellationToken)

Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un proxy per l'attività restituita da function. Un token di annullamento consente di annullare il lavoro se non è ancora stato avviato.
Run(Func<Task>)

Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un proxy per l'attività restituita da function.
Run<TResult>(Func<Task<TResult>>, CancellationToken)

Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un proxy per l'oggetto Task(TResult) restituito da function.
Run<TResult>(Func<Task<TResult>>)

Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un proxy per l'oggetto Task(TResult) restituito da function. Un token di annullamento consente di annullare il lavoro se non è ancora stato avviato.
Run<TResult>(Func<TResult>, CancellationToken)

Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un Task(TResult) oggetto che rappresenta tale lavoro.
Run<TResult>(Func<TResult>)

Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un Task<TResult> oggetto che rappresenta tale lavoro. Un token di annullamento consente di annullare il lavoro se non è ancora stato avviato.
RunSynchronously()

Esegue in Task modo sincrono sull'oggetto corrente TaskScheduler.
RunSynchronously(TaskScheduler)

Esegue l'oggetto Task in modo sincrono sull'oggetto TaskScheduler fornito.
Start()

Avvia , Taskpianificandolo per l'esecuzione nell'oggetto corrente TaskScheduler.
Start(TaskScheduler)

Avvia , Taskpianificandolo per l'esecuzione nell'oggetto specificato TaskScheduler.
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
Wait()

Attende il completamento dell'esecuzione Task .
Wait(CancellationToken)

Attende il completamento dell'esecuzione Task . L'attesa termina se un token di annullamento viene annullato prima del completamento dell'attività.
Wait(Int32, CancellationToken)

Attende il completamento dell'esecuzione Task . L'attesa termina se un intervallo di timeout è trascorso o un token di annullamento viene annullato prima del completamento dell'attività.
Wait(Int32)

Attende il completamento dell'esecuzione Task entro un numero specificato di millisecondi.
Wait(TimeSpan, CancellationToken)

Attende il completamento dell'esecuzione Task .
Wait(TimeSpan)

Attende il completamento dell'esecuzione Task entro un intervallo di tempo specificato.
WaitAll(IEnumerable<Task>, CancellationToken)

Attende il completamento dell'esecuzione di tutti gli oggetti forniti Task , a meno che l'attesa non venga annullata.
WaitAll(ReadOnlySpan<Task>)

Attende il completamento dell'esecuzione di tutti gli oggetti forniti Task .
WaitAll(Task[], CancellationToken)

Attende il completamento dell'esecuzione di tutti gli oggetti forniti Task , a meno che l'attesa non venga annullata.
WaitAll(Task[], Int32, CancellationToken)

Attende il completamento dell'esecuzione di tutti gli oggetti forniti Task entro un numero specificato di millisecondi o fino all'annullamento dell'attesa.
WaitAll(Task[], Int32)

Attende che tutti gli oggetti forniti Task completino l'esecuzione entro un numero specificato di millisecondi.
WaitAll(Task[], TimeSpan)

Attende che tutti gli oggetti annullabili Task forniti completino l'esecuzione entro un intervallo di tempo specificato.
WaitAll(Task[])

Attende il completamento dell'esecuzione di tutti gli oggetti forniti Task .
WaitAny(Task[], CancellationToken)

Attende il completamento dell'esecuzione di uno degli oggetti forniti Task , a meno che l'attesa non venga annullata.
WaitAny(Task[], Int32, CancellationToken)

Attende il completamento dell'esecuzione di uno degli oggetti forniti Task entro un numero specificato di millisecondi o fino a quando non viene annullato un token di annullamento.
WaitAny(Task[], Int32)

Attende il completamento dell'esecuzione di uno degli oggetti forniti Task entro un numero specificato di millisecondi.
WaitAny(Task[], TimeSpan)

Attende il completamento dell'esecuzione di uno degli oggetti forniti Task entro un intervallo di tempo specificato.
WaitAny(Task[])

Attende il completamento dell'esecuzione di uno degli oggetti forniti Task .
WaitAsync(CancellationToken)

Ottiene un oggetto Task che verrà completato al Task termine dell'operazione o quando è stato richiesto l'annullamento specificato CancellationToken .
WaitAsync(TimeSpan, CancellationToken)

Ottiene un oggetto Task che verrà completato al Task termine dell'operazione, alla scadenza del timeout specificato o alla richiesta di annullamento dell'oggetto specificato CancellationToken .
WaitAsync(TimeSpan, TimeProvider, CancellationToken)

Ottiene un oggetto Task che verrà completato al Task termine dell'operazione, alla scadenza del timeout specificato o alla richiesta di annullamento dell'oggetto specificato CancellationToken .
WaitAsync(TimeSpan, TimeProvider)

Ottiene un oggetto Task che verrà completato al Task termine o alla scadenza del timeout specificato.
WaitAsync(TimeSpan)

Ottiene un oggetto Task che verrà completato al Task termine o alla scadenza del timeout specificato.
WhenAll(IEnumerable<Task>)

Crea un'attività che verrà completata al termine di tutti gli Task oggetti di una raccolta enumerabile.
WhenAll(ReadOnlySpan<Task>)

Crea un'attività che verrà completata al termine di tutte le attività fornite.
WhenAll(Task[])

Crea un'attività che verrà completata al termine di tutti gli Task oggetti in una matrice.
WhenAll<TResult>(IEnumerable<Task<TResult>>)

Crea un'attività che verrà completata al termine di tutti gli Task<TResult> oggetti di una raccolta enumerabile.
WhenAll<TResult>(ReadOnlySpan<Task<TResult>>)

Crea un'attività che verrà completata al termine di tutte le attività fornite.
WhenAll<TResult>(Task<TResult>[])

Crea un'attività che verrà completata al termine di tutti gli Task<TResult> oggetti in una matrice.
WhenAny(IEnumerable<Task>)

Crea un'attività che verrà completata al termine di una delle attività fornite.
WhenAny(ReadOnlySpan<Task>)

Crea un'attività che verrà completata al termine di una delle attività fornite.
WhenAny(Task, Task)

Crea un'attività che verrà completata al termine di una delle attività fornite.
WhenAny(Task[])

Crea un'attività che verrà completata al termine di una delle attività fornite.
WhenAny<TResult>(IEnumerable<Task<TResult>>)

Crea un'attività che verrà completata al termine di una delle attività fornite.
WhenAny<TResult>(ReadOnlySpan<Task<TResult>>)

Crea un'attività che verrà completata al termine di una delle attività fornite.
WhenAny<TResult>(Task<TResult>, Task<TResult>)

Crea un'attività che verrà completata al termine di una delle attività fornite.
WhenAny<TResult>(Task<TResult>[])

Crea un'attività che verrà completata al termine di una delle attività fornite.
WhenEach(IEnumerable<Task>)

Crea un oggetto IAsyncEnumerable<T> che restituirà le attività fornite al termine di tali attività.
WhenEach(ReadOnlySpan<Task>)

Crea un oggetto IAsyncEnumerable<T> che restituirà le attività fornite al termine di tali attività.
WhenEach(Task[])

Crea un oggetto IAsyncEnumerable<T> che restituirà le attività fornite al termine di tali attività.
WhenEach<TResult>(IEnumerable<Task<TResult>>)

Crea un oggetto IAsyncEnumerable<T> che restituirà le attività fornite al termine di tali attività.
WhenEach<TResult>(ReadOnlySpan<Task<TResult>>)

Crea un oggetto IAsyncEnumerable<T> che restituirà le attività fornite al termine di tali attività.
WhenEach<TResult>(Task<TResult>[])

Crea un oggetto IAsyncEnumerable<T> che restituirà le attività fornite al termine di tali attività.
Yield()

Crea un'attività awaitable che restituisce in modo asincrono al contesto corrente quando è atteso.

Implementazioni dell'interfaccia esplicita

Nome Descrizione
IAsyncResult.AsyncWaitHandle

Ottiene un WaitHandle oggetto che può essere utilizzato per attendere il completamento dell'attività.
IAsyncResult.CompletedSynchronously

Ottiene un'indicazione di se l'operazione è stata completata in modo sincrono.

Metodi di estensione

Nome Descrizione
AsAsyncAction(Task)

Restituisce un'azione asincrona di Windows Runtime che rappresenta un'attività avviata.
DispatcherOperationWait(Task, TimeSpan)

Attende il tempo specificato per il completamento dell'oggetto sottostante DispatcherOperation .
DispatcherOperationWait(Task)

Attende il completamento indefinito dell'oggetto sottostante DispatcherOperation .
IsDispatcherOperationTask(Task)

Restituisce un valore che indica se l'oggetto Task è associato a un oggetto DispatcherOperation.

Si applica a

Thread safety

Tutti i membri di , ad eccezione Taskdi Dispose(), sono thread-safe e possono essere usati contemporaneamente da più thread.

Vedi anche