Task Classe

Definizione

Spazio dei nomi:

System.Threading.Tasks

Assembly:

System.Runtime.dll

Source:

Task.cs

Rappresenta un'operazione asincrona.

public ref class Task : IAsyncResult, IDisposable

public class Task : IAsyncResult, IDisposable

type Task = class
    interface IAsyncResult
    interface IDisposable

Public Class Task
Implements IAsyncResult, IDisposable

Ereditarietà

Object

Task

Derivato

System.Threading.Tasks.Task<TResult>

Implementazioni

IAsyncResult IDisposable

Commenti

Per altre informazioni su questa API, vedere Note sulle API supplementari per l'attività.

Costruttori

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

Proprietà

AsyncState	Ottiene l'oggetto stato fornito quando è stato creato Task oppure null se non ne è stato fornito alcuno.
CompletedTask	Ottiene un'attività già completata correttamente.
CreationOptions	Ottiene l'oggetto TaskCreationOptions usato per creare questa attività.
CurrentId	Restituisce l'ID dell'oggetto Task attualmente in esecuzione.
Exception	Ottiene l'oggetto AggregateException che ha causato l'interruzione anomala di Task. Se l'oggetto Task è stato completato correttamente o non ha ancora generato alcuna eccezione, verrà restituito null.
Factory	Fornisce l'accesso ai metodi factory per la creazione e la configurazione delle istanze di Task e Task<TResult>.
Id	Ottiene un ID per questa istanza di Task.
IsCanceled	Ottiene un valore che indica se l'esecuzione di questa istanza di Task è stata completata perché annullata.
IsCompleted	Ottiene un valore che indica l'eventuale completamento dell'attività.
IsCompletedSuccessfully	Ottiene un valore che indica se l'esecuzione dell'attività è stata completata.
IsFaulted	Ottiene un valore che indica se l'oggetto Task è stato completato a causa di un'eccezione non gestita.
Status	Ottiene l'oggetto TaskStatus di questa attività.

Metodi

ConfigureAwait(Boolean)	Configura un elemento awaiter usato per attendere questo oggetto Task.
ConfigureAwait(ConfigureAwaitOptions)	Configura un elemento awaiter usato per attendere questo oggetto Task.
ContinueWith(Action<Task,Object>, Object)	Crea una continuazione che riceve informazioni sullo stato fornite dal chiamante e viene eseguita al completamento dell'oggetto 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 dell'oggetto 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 e che viene eseguita al completamento dell'oggetto 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 completamento dell'oggetto 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 completamento dell'oggetto Task di destinazione. La continuazione usa un'utilità di pianificazione specificata.
ContinueWith(Action<Task>)	Crea una continuazione che viene eseguita in modo asincrono al completamento dell'oggetto Task di destinazione.
ContinueWith(Action<Task>, CancellationToken)	Crea una continuazione che riceve un token di annullamento e viene eseguita in modo asincrono al completamento dell'oggetto Task di destinazione.
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crea una continuazione che viene eseguita al completamento dell'attività di destinazione in base all'oggetto TaskContinuationOptions specificato. La continuazione riceve un token di annullamento e usa un'utilità di pianificazione specificata.
ContinueWith(Action<Task>, TaskContinuationOptions)	Crea una continuazione che viene eseguita al completamento dell'attività di destinazione in base all'oggetto TaskContinuationOptions specificato.
ContinueWith(Action<Task>, TaskScheduler)	Crea una continuazione che viene eseguita in modo asincrono al completamento dell'oggetto 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 al completamento dell'oggetto Task di destinazione, quindi restituisce un valore.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)	Crea una continuazione che viene eseguita in modo asincrono al completamento dell'oggetto Task di destinazione 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 specificate per la continuazione delle attività al completamento dell'oggetto Task di destinazione, quindi restituisce un valore. La continuazione riceve informazioni sullo stato fornite dal chiamante e un token di annullamento, quindi usa l'utilità di pianificazione specificata.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskContinuationOptions)	Crea una continuazione che viene eseguita in base alle opzioni specificate per la continuazione delle attività al completamento dell'oggetto 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 completamento dell'oggetto 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 che viene eseguita in modo asincrono al completamento dell'oggetto Task<TResult> di destinazione e restituisce un valore.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)	Crea una continuazione che viene eseguita in modo asincrono al completamento dell'oggetto Task di destinazione e restituisce un valore. La continuazione riceve un token di annullamento.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crea una continuazione che viene eseguita in base alle opzioni di continuazione specificate e restituisce un valore. La continuazione riceve un token di annullamento e usa un'utilità di pianificazione specificata.
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)	Crea una continuazione che viene 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 completamento dell'oggetto Task di destinazione e restituisce un valore. La continuazione usa un'utilità di pianificazione specificata.
Delay(Int32)	Crea un'attività che viene completata dopo un numero di millisecondi specificato.
Delay(Int32, CancellationToken)	Crea un'attività annullabile che viene completata dopo un numero di millisecondi specificato.
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 Task, rilasciandone 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 che risulta completato a causa dell'annullamento con un token di annullamento specificato.
FromCanceled<TResult>(CancellationToken)	Crea un oggetto Task<TResult> che risulta completato a causa dell'annullamento con un token di annullamento specificato.
FromException(Exception)	Crea un oggetto Task che risulta completato con un'eccezione specificata.
FromException<TResult>(Exception)	Crea un oggetto Task<TResult> che risulta completato con un'eccezione specificata.
FromResult<TResult>(TResult)	Crea un Task<TResult> che viene completato correttamente con il risultato specificato.
GetAwaiter()	Ottiene un elemento awaiter usato per attendere questo oggetto Task.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (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 l'annullamento del lavoro se non è ancora stato avviato.
Run(Func<Task>)	Accoda il lavoro specificato da eseguire sul pool di thread e restituisce un proxy per l'attività restituita da function.
Run(Func<Task>, CancellationToken)	Accoda il lavoro specificato da eseguire sul pool di thread e restituisce un proxy per l'attività restituita da function. Un token di annullamento consente l'annullamento del 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 l'oggetto Task(TResult) restituito da function. Un token di annullamento consente l'annullamento del 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 l'oggetto 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 l'annullamento del 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 Task in modo sincrono nell'oggetto TaskScheduler corrente.
RunSynchronously(TaskScheduler)	Esegue Task in modo sincrono nell'oggetto TaskScheduler fornito.
Start()	Avvia Task, pianificandone l'esecuzione nell'oggetto TaskScheduler corrente.
Start(TaskScheduler)	Avvia Task, pianificandone l'esecuzione nell'oggetto TaskScheduler specificato.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Wait()	Attende il completamento dell'esecuzione di Task.
Wait(CancellationToken)	Attende il completamento dell'esecuzione di Task. L'attesa termina se un token di annullamento viene annullato prima del completamento dell'attività.
Wait(Int32)	Attende il completamento dell'esecuzione di Task entro un numero specificato di millisecondi.
Wait(Int32, CancellationToken)	Attende il completamento dell'esecuzione di Task. L'attesa termina se si esaurisce l'intervallo di timeout o se un token di annullamento viene annullato prima del completamento dell'attività.
Wait(TimeSpan)	Attende il completamento dell'esecuzione di Task entro un intervallo di tempo specificato.
Wait(TimeSpan, CancellationToken)	Attende il completamento dell'esecuzione di 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 il completamento dell'esecuzione di tutti gli oggetti Task forniti entro un numero specificato di millisecondi.
WaitAll(Task[], Int32, CancellationToken)	Attende il completamento dell'esecuzione di tutti gli oggetti Task forniti entro un numero specificato di millisecondi o finché l'attesa non viene annullata.
WaitAll(Task[], TimeSpan)	Attende il completamento dell'esecuzione di tutti gli oggetti Task forniti annullabili entro un intervallo di tempo specificato.
WaitAny(Task[])	Attende il completamento dell'esecuzione di uno qualsiasi degli oggetti Task forniti.
WaitAny(Task[], CancellationToken)	Attende il completamento dell'esecuzione di uno qualsiasi degli oggetti Task forniti a meno che l'attesa non venga annullata.
WaitAny(Task[], Int32)	Attende il completamento dell'esecuzione di uno qualsiasi degli oggetti Task forniti entro un numero specificato di millisecondi.
WaitAny(Task[], Int32, CancellationToken)	Attende il completamento dell'esecuzione di uno qualsiasi degli oggetti Task forniti entro un numero specificato di millisecondi o finché un token di annullamento non viene annullato.
WaitAny(Task[], TimeSpan)	Attende il completamento dell'esecuzione di uno qualsiasi degli oggetti Task forniti entro un intervallo di tempo specificato.
WaitAsync(CancellationToken)	Ottiene un Task oggetto che verrà completato al Task termine dell'operazione o quando l'oggetto specificato CancellationToken ha richiesto l'annullamento.
WaitAsync(TimeSpan)	Ottiene un Task oggetto che verrà completato al Task termine o alla scadenza del timeout specificato.
WaitAsync(TimeSpan, CancellationToken)	Ottiene un Task oggetto che verrà completato Task al termine, alla scadenza del timeout specificato o alla richiesta di annullamento dell'oggetto specificato CancellationToken .
WaitAsync(TimeSpan, TimeProvider)	Ottiene un Task oggetto che verrà completato al Task termine o alla scadenza del timeout specificato.
WaitAsync(TimeSpan, TimeProvider, CancellationToken)	Ottiene un Task oggetto che verrà completato Task al termine, alla scadenza del timeout specificato o alla richiesta di annullamento dell'oggetto specificato CancellationToken .
WhenAll(IEnumerable<Task>)	Crea un'attività che verrà completata in seguito al completamento di tutti gli oggetti Task in una raccolta enumerabile.
WhenAll(Task[])	Crea un'attività che verrà completata in seguito al completamento di tutti gli oggetti Task in una matrice.
WhenAll<TResult>(IEnumerable<Task<TResult>>)	Crea un'attività che verrà completata in seguito al completamento di tutti gli oggetti Task<TResult> in una raccolta enumerabile.
WhenAll<TResult>(Task<TResult>[])	Crea un'attività che verrà completata in seguito al completamento di tutti gli oggetti Task<TResult> in una matrice.
WhenAny(IEnumerable<Task>)	Crea un'attività che verrà completata quando tutte le attività fornite saranno completate.
WhenAny(Task, Task)	Crea un'attività che verrà completata quando sarà completata una delle attività fornite.
WhenAny(Task[])	Crea un'attività che verrà completata quando tutte le attività fornite saranno completate.
WhenAny<TResult>(IEnumerable<Task<TResult>>)	Crea un'attività che verrà completata quando tutte le attività fornite saranno completate.
WhenAny<TResult>(Task<TResult>, Task<TResult>)	Crea un'attività che verrà completata quando sarà completata una delle attività fornite.
WhenAny<TResult>(Task<TResult>[])	Crea un'attività che verrà completata quando tutte le attività fornite saranno completate.
Yield()	Crea un'attività awaitable che consente il passaggio in modo asincrono al contesto corrente, quando atteso.

Implementazioni dell'interfaccia esplicita

IAsyncResult.AsyncWaitHandle	Ottiene un oggetto WaitHandle che può essere usato per attendere il completamento dell'attività.
IAsyncResult.CompletedSynchronously	Ottiene un valore che indica se l'operazione è stata completata in modo sincrono.

Metodi di estensione

Thread safety

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

Vedi anche

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