Task Classe

Definizione

Spazio dei nomi:

System.Threading.Tasks

Assembly:

System.Runtime.dll

Origine:

Task.cs

Rappresenta un'operazione asincrona.

C#

public class Task : IAsyncResult, IDisposable

Ereditarietà

Object

Task

Derivato

System.Threading.Tasks.Task<TResult>

Implementazioni

IAsyncResult IDisposable

Commenti

Per altre informazioni su questa API, vedere osservazioni supplementari sull'API per Task.

Costruttori

Task(Action)	Inizializza una nuova Task con l'azione specificata.
Task(Action, CancellationToken)	Inizializza una nuova Task con l'azione specificata e CancellationToken.
Task(Action, CancellationToken, TaskCreationOptions)	Inizializza una nuova Task con l'azione e le opzioni di creazione specificate.
Task(Action, TaskCreationOptions)	Inizializza una nuova Task con l'azione e le opzioni di creazione specificate.
Task(Action<Object>, Object)	Inizializza una nuova Task con l'azione e lo stato specificati.
Task(Action<Object>, Object, CancellationToken)	Inizializza una nuova Task con l'azione, lo stato e l'CancellationTokenspecificati.
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)	Inizializza una nuova Task con l'azione, lo stato e le opzioni specificati.
Task(Action<Object>, Object, TaskCreationOptions)	Inizializza una nuova Task con l'azione, lo stato e le opzioni specificati.

Proprietà

AsyncState	Ottiene l'oggetto di stato fornito quando è stato creato il Task oppure null se non è stato specificato alcun oggetto.
CompletedTask	Ottiene un'attività che è già stata completata correttamente.
CreationOptions	Ottiene il TaskCreationOptions utilizzato per creare questa attività.
CurrentId	Restituisce l'ID dell'oggetto attualmente in esecuzione Task.
Exception	Ottiene il AggregateException che ha causato la fine prematura del Task. Se il Task completato correttamente o non ha ancora generato eccezioni, verrà restituito null.
Factory	Fornisce l'accesso ai metodi factory per la creazione e la configurazione di istanze di Task e Task<TResult>.
Id	Ottiene un ID per questa istanza di Task.
IsCanceled	Ottiene un valore che indica se l'istanza di Task è 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 il Task è stato completato a causa di un'eccezione non gestita.
Status	Ottiene il TaskStatus di questa attività.

Metodi

ConfigureAwait(Boolean)	Configura un awaiter usato per attendere questo Task.
ConfigureAwait(ConfigureAwaitOptions)	Configura un awaiter usato per attendere questo Task.
ContinueWith(Action<Task,Object>, Object)	Crea una continuazione che riceve informazioni sullo stato fornite dal chiamante e viene eseguita al termine dell'Task di destinazione.
ContinueWith(Action<Task,Object>, Object, CancellationToken)	Crea una continuazione che riceve informazioni sullo stato fornite dal chiamante e un token di annullamento e che viene eseguita in modo asincrono al completamento del Task di destinazione.
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 dell'Task di destinazione. La continuazione viene eseguita in base a un set di condizioni specificate e usa un'utilità di pianificazione specificata.
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions)	Crea una continuazione che riceve informazioni sullo stato fornite dal chiamante e viene eseguita al termine dell'Task di destinazione. 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 dell'Task di destinazione. La continuazione usa un'utilità di pianificazione specificata.
ContinueWith(Action<Task>)	Crea una continuazione che viene eseguita in modo asincrono al termine del Task di destinazione.
ContinueWith(Action<Task>, CancellationToken)	Crea una continuazione che riceve un token di annullamento ed viene eseguita in modo asincrono al termine dell'Task di destinazione.
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crea una continuazione eseguita quando l'attività di destinazione compete in base al TaskContinuationOptionsspecificato. La continuazione riceve un token di annullamento e usa un'utilità di pianificazione specificata.
ContinueWith(Action<Task>, TaskContinuationOptions)	Crea una continuazione che viene eseguita quando l'attività di destinazione viene completata in base al TaskContinuationOptionsspecificato.
ContinueWith(Action<Task>, TaskScheduler)	Crea una continuazione che viene eseguita in modo asincrono al termine del Task di destinazione. La continuazione 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 quando il Task di destinazione viene completato e restituisce un valore.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)	Crea una continuazione eseguita in modo asincrono quando il Task di destinazione viene completato 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, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crea una continuazione che viene eseguita in base alle opzioni di continuazione dell'attività specificate quando il Task di destinazione viene completato 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, TaskContinuationOptions)	Crea una continuazione eseguita in base alle opzioni di continuazione dell'attività specificate al termine dell'Task di destinazione. 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 del Task di destinazione. La continuazione riceve informazioni sullo stato fornite dal chiamante e usa un'utilità di pianificazione specificata.
ContinueWith<TResult>(Func<Task,TResult>)	Crea una continuazione eseguita in modo asincrono quando il Task<TResult> di destinazione viene completato e restituisce un valore.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)	Crea una continuazione eseguita in modo asincrono quando il Task di destinazione viene completato e restituisce un valore. La continuazione riceve un token di annullamento.
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>, 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 eseguita in modo asincrono quando il Task di destinazione viene completato e restituisce un valore. La continuazione usa un'utilità di pianificazione specificata.
Delay(Int32)	Crea un'attività che viene completata dopo un numero specificato di millisecondi.
Delay(Int32, CancellationToken)	Crea un'attività annullabile che viene completata dopo un numero specificato di millisecondi.
Delay(TimeSpan)	Crea un'attività che viene completata dopo un intervallo di tempo specificato.
Delay(TimeSpan, 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, TimeProvider, CancellationToken)	Crea un'attività annullabile che viene completata dopo un intervallo di tempo specificato.
Dispose()	Rilascia tutte le risorse usate dall'istanza corrente della classe Task.
Dispose(Boolean)	Elimina il Task, rilasciando tutte le relative risorse non gestite.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FromCanceled(CancellationToken)	Crea un Task completato a causa dell'annullamento con un token di annullamento specificato.
FromCanceled<TResult>(CancellationToken)	Crea un Task<TResult> completato a causa dell'annullamento con un token di annullamento specificato.
FromException(Exception)	Crea un Task completato con un'eccezione specificata.
FromException<TResult>(Exception)	Crea un Task<TResult> completato con un'eccezione specificata.
FromResult<TResult>(TResult)	Crea un Task<TResult> completato correttamente con il risultato specificato.
GetAwaiter()	Ottiene un awaiter utilizzato per attendere questo Task.
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)	Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un oggetto Task che rappresenta tale lavoro.
Run(Action, CancellationToken)	Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un oggetto Task che rappresenta tale lavoro. 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(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<TResult>(Func<Task<TResult>>)	Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un proxy per il Task(TResult) restituito da function. Un token di annullamento consente di annullare il lavoro se non è ancora stato avviato.
Run<TResult>(Func<Task<TResult>>, CancellationToken)	Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un proxy per il Task(TResult) restituito da function.
Run<TResult>(Func<TResult>)	Accoda il lavoro specificato da eseguire nel pool di thread e restituisce un oggetto Task<TResult> che rappresenta tale lavoro. 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 oggetto Task(TResult) che rappresenta tale lavoro.
RunSynchronously()	Esegue il Task in modo sincrono sul TaskSchedulercorrente.
RunSynchronously(TaskScheduler)	Esegue il Task in modo sincrono sul TaskScheduler fornito.
Start()	Avvia il Task, pianificandolo per l'esecuzione nel TaskSchedulercorrente.
Start(TaskScheduler)	Avvia il Task, pianificandolo per l'esecuzione nel TaskSchedulerspecificato.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Wait()	Attende il completamento dell'esecuzione del Task.
Wait(CancellationToken)	Attende il completamento dell'esecuzione del Task. L'attesa termina se un token di annullamento viene annullato prima del completamento dell'attività.
Wait(Int32)	Attende che il Task completi l'esecuzione entro un numero specificato di millisecondi.
Wait(Int32, CancellationToken)	Attende il completamento dell'esecuzione del Task. L'attesa termina se un intervallo di timeout è trascorso o un token di annullamento viene annullato prima del completamento dell'attività.
Wait(TimeSpan)	Attende che il Task completi l'esecuzione entro un intervallo di tempo specificato.
Wait(TimeSpan, CancellationToken)	Attende il completamento dell'esecuzione del Task.
WaitAll(Task[])	Attende il completamento dell'esecuzione di tutti gli oggetti Task forniti.
WaitAll(Task[], CancellationToken)	Attende il completamento dell'esecuzione di tutti gli oggetti Task forniti, a meno che l'attesa non venga annullata.
WaitAll(Task[], Int32)	Attende che tutti gli oggetti Task forniti completino l'esecuzione entro un numero specificato di millisecondi.
WaitAll(Task[], Int32, CancellationToken)	Attende che tutti gli oggetti Task forniti completino l'esecuzione entro un numero specificato di millisecondi o fino a quando l'attesa non viene annullata.
WaitAll(Task[], TimeSpan)	Attende che tutti gli oggetti annullabili forniti Task completino l'esecuzione entro un intervallo di tempo specificato.
WaitAny(Task[])	Attende il completamento dell'esecuzione di uno degli oggetti Task forniti.
WaitAny(Task[], CancellationToken)	Attende il completamento dell'esecuzione di uno degli oggetti Task forniti, a meno che l'attesa non venga annullata.
WaitAny(Task[], Int32)	Attende il completamento dell'esecuzione di uno degli oggetti Task forniti entro un numero specificato di millisecondi.
WaitAny(Task[], Int32, CancellationToken)	Attende che uno degli oggetti Task forniti completi l'esecuzione entro un numero specificato di millisecondi o fino a quando non viene annullato un token di annullamento.
WaitAny(Task[], TimeSpan)	Attende il completamento dell'esecuzione di uno degli oggetti Task forniti entro un intervallo di tempo specificato.
WaitAsync(CancellationToken)	Ottiene un Task che verrà completato al termine dell'Task o quando è stato richiesto l'annullamento dell'CancellationToken specificato.
WaitAsync(TimeSpan)	Ottiene un Task che verrà completato al termine dell'Task o alla scadenza del timeout specificato.
WaitAsync(TimeSpan, CancellationToken)	Ottiene un Task che verrà completato al termine dell'Task, alla scadenza del timeout specificato o alla richiesta di annullamento dell'CancellationToken specificato.
WaitAsync(TimeSpan, TimeProvider)	Ottiene un Task che verrà completato al termine dell'Task o alla scadenza del timeout specificato.
WaitAsync(TimeSpan, TimeProvider, CancellationToken)	Ottiene un Task che verrà completato al termine dell'Task, alla scadenza del timeout specificato o alla richiesta di annullamento dell'CancellationToken specificato.
WhenAll(IEnumerable<Task>)	Crea un'attività che verrà completata al termine di tutti gli oggetti Task in un insieme enumerabile.
WhenAll(Task[])	Crea un'attività che verrà completata al termine di tutti gli oggetti Task in una matrice.
WhenAll<TResult>(IEnumerable<Task<TResult>>)	Crea un'attività che verrà completata al termine di tutti gli oggetti Task<TResult> in un insieme enumerabile.
WhenAll<TResult>(Task<TResult>[])	Crea un'attività che verrà completata al termine di tutti gli oggetti Task<TResult> in una matrice.
WhenAny(IEnumerable<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>(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.
Yield()	Crea un'attività awaitable che restituisce in modo asincrono al contesto corrente quando è atteso.

Implementazioni dell'interfaccia esplicita

IAsyncResult.AsyncWaitHandle	Ottiene un WaitHandle 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

WaitAsync(Task, TimeSpan, TimeProvider, CancellationToken)

Ottiene un Task che verrà completato al termine dell'Task, alla scadenza del timeout specificato o alla richiesta di annullamento dell'CancellationToken specificato.

Si applica a

Thread safety

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

Vedi anche

• Task<TResult>
• Task Parallel Library (TPL)
• modello asincrono basato su attività (TAP) in .NET: Introduzione e panoramica
• di programmazione asincrona basata su attività
• esempi per la programmazione parallela con .NET Core e .NET Standard