Condividi tramite


Task Classe

Definizione

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à
Task
Derivato
Implementazioni

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

Attende il completamento dell'esecuzione di tutti gli oggetti Task forniti, a meno che l'attesa non venga annullata.

WaitAll(ReadOnlySpan<Task>)

Attende il completamento dell'esecuzione di tutti gli oggetti Task forniti.

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(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 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>(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 oggetti Task<TResult> 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 IAsyncEnumerable<T> che restituirà le attività fornite al termine di tali attività.

WhenEach(ReadOnlySpan<Task>)

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

WhenEach(Task[])

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

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

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

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

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

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

Crea un 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

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.

DispatcherOperationWait(Task)

Attende il completamento illimitato del DispatcherOperation sottostante.

DispatcherOperationWait(Task, TimeSpan)

Attende il completamento dell'intervallo di tempo specificato per il completamento del DispatcherOperation sottostante.

IsDispatcherOperationTask(Task)

Restituisce un valore che indica se questo Task è associato a un DispatcherOperation.

AsAsyncAction(Task)

Restituisce un'azione asincrona di Windows Runtime che rappresenta un'attività avviata.

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