TaskFactory<TResult>.StartNew Metodo

Definizione

Spazio dei nomi:

System.Threading.Tasks

Assembly:

System.Runtime.dll

Crea e avvia un'attività.

Overload

StartNew(Func<Object,TResult>, Object, CancellationToken)	Crea e avvia un'attività.
StartNew(Func<Object,TResult>, Object, TaskCreationOptions)	Crea e avvia un'attività.
StartNew(Func<TResult>, TaskCreationOptions)	Crea e avvia un'attività.
StartNew(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)	Crea e avvia un'attività.
StartNew(Func<Object,TResult>, Object)	Crea e avvia un'attività.
StartNew(Func<TResult>)	Crea e avvia un'attività.
StartNew(Func<TResult>, CancellationToken)	Crea e avvia un'attività.
StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	Crea e avvia un'attività.

StartNew(Func<Object,TResult>, Object, CancellationToken)

Origine:

FutureFactory.cs

Crea e avvia un'attività.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken) As Task(Of TResult)

Parametri

function

Func<Object,TResult>

Delegato della funzione che restituisce il risultato futuro da rendere disponibile tramite l'attività.

state

Object

Oggetto contenente i dati che devono essere usati dal delegato function.

cancellationToken

CancellationToken

Token di annullamento che verrà assegnato alla nuova attività.

Restituisce

Task<TResult>

Attività avviata.

Eccezioni

ObjectDisposedException

L'origine del token di annullamento che ha creato cancellationToken è già stata eliminata.

ArgumentNullException

Il valore dell'argomento function è null.

Commenti

La chiamata StartNew è funzionalmente equivalente alla creazione di un'attività usando uno dei Task<TResult> costruttori e quindi chiamando il metodo per pianificarla per l'esecuzione Start .

Tuttavia, a meno che la creazione e la pianificazione non siano separate, StartNew è l'approccio consigliato sia per semplicità che per le prestazioni.

Vedi anche

• Task Parallel Library (TPL)
• Uso di TPL con altri modelli asincroni

StartNew(Func<Object,TResult>, Object, TaskCreationOptions)

Origine:

FutureFactory.cs

Crea e avvia un'attività.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state, System.Threading.Tasks.TaskCreationOptions creationOptions);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions) As Task(Of TResult)

Parametri

function

Func<Object,TResult>

Delegato della funzione che restituisce il risultato futuro da rendere disponibile tramite l'attività.

state

Object

Oggetto contenente i dati che devono essere usati dal delegato function.

creationOptions

TaskCreationOptions

Uno dei valori di enumerazione che controlla il comportamento dell'attività creata.

Restituisce

Task<TResult>

Attività avviata.

Eccezioni

ArgumentNullException

Il valore dell'argomento function è null.

ArgumentOutOfRangeException

Nel parametro creationOptions è stato specificato un valore non valido.

Commenti

La chiamata StartNew è funzionalmente equivalente alla creazione di un'attività usando uno dei Task<TResult> costruttori e quindi chiamando il metodo per pianificarla per l'esecuzione Start .

Tuttavia, a meno che la creazione e la pianificazione non siano separate, StartNew è l'approccio consigliato sia per semplicità che per le prestazioni.

Vedi anche

• Task Parallel Library (TPL)
• Uso di TPL con altri modelli asincroni

StartNew(Func<TResult>, TaskCreationOptions)

Origine:

FutureFactory.cs

Crea e avvia un'attività.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function, System.Threading.Tasks.TaskCreationOptions creationOptions);

member this.StartNew : Func<'Result> * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), creationOptions As TaskCreationOptions) As Task(Of TResult)

Parametri

function

Func<TResult>

Delegato della funzione che restituisce il risultato futuro da rendere disponibile tramite l'attività.

creationOptions

TaskCreationOptions

Uno dei valori di enumerazione che controlla il comportamento dell'attività creata.

Restituisce

Task<TResult>

Oggetto Task<TResult> avviato.

Eccezioni

ArgumentNullException

Il valore dell'argomento function è null.

ArgumentOutOfRangeException

Nel parametro creationOptions è stato specificato un valore non valido.

Commenti

La chiamata StartNew è funzionalmente equivalente alla creazione di un'attività usando uno dei Task<TResult> costruttori e quindi chiamando il metodo per pianificarla per l'esecuzione Start .

Tuttavia, a meno che la creazione e la pianificazione non siano separate, StartNew è l'approccio consigliato sia per semplicità che per le prestazioni.

Vedi anche

• Task Parallel Library (TPL)
• Uso di TPL con altri modelli asincroni

StartNew(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)

Origine:

FutureFactory.cs

Crea e avvia un'attività.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.StartNew : Func<'Result> * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

Parametri

function

Func<TResult>

Delegato della funzione che restituisce il risultato futuro da rendere disponibile tramite l'attività.

cancellationToken

CancellationToken

Token di annullamento che verrà assegnato alla nuova attività.

creationOptions

TaskCreationOptions

Uno dei valori di enumerazione che controlla il comportamento dell'attività creata.

scheduler

TaskScheduler

Utilità di pianificazione usata per pianificare l'attività creata.

Restituisce

Task<TResult>

Attività avviata.

Eccezioni

ObjectDisposedException

L'origine del token di annullamento che ha creato cancellationToken è già stata eliminata.

ArgumentNullException

Il valore dell'argomento function è null.

-oppure-

Il valore dell'argomento scheduler è null.

ArgumentOutOfRangeException

Nel parametro creationOptions è stato specificato un valore non valido.

Commenti

La chiamata StartNew è funzionalmente equivalente alla creazione di un'attività usando uno dei Task<TResult> costruttori e quindi chiamando il metodo per pianificarla per l'esecuzione Start .

Tuttavia, a meno che la creazione e la pianificazione non siano separate, StartNew è l'approccio consigliato sia per semplicità che per le prestazioni.

Vedi anche

• Task Parallel Library (TPL)
• Uso di TPL con altri modelli asincroni

StartNew(Func<Object,TResult>, Object)

Origine:

FutureFactory.cs

Crea e avvia un'attività.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state);

member this.StartNew : Func<obj, 'Result> * obj -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object) As Task(Of TResult)

Parametri

function

Func<Object,TResult>

Delegato della funzione che restituisce il risultato futuro da rendere disponibile tramite l'attività.

state

Object

Oggetto contenente i dati che devono essere usati dal delegato function.

Restituisce

Task<TResult>

Attività avviata.

Eccezioni

ArgumentNullException

Il valore dell'argomento function è null.

Commenti

La chiamata StartNew è funzionalmente equivalente alla creazione di un'attività usando uno dei Task<TResult> costruttori e quindi chiamando il metodo per pianificarla per l'esecuzione Start .

Tuttavia, a meno che la creazione e la pianificazione non siano separate, StartNew è l'approccio consigliato sia per semplicità che per le prestazioni.

Vedi anche

• Task Parallel Library (TPL)
• Uso di TPL con altri modelli asincroni

StartNew(Func<TResult>)

Origine:

FutureFactory.cs

Crea e avvia un'attività.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function);

member this.StartNew : Func<'Result> -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult)) As Task(Of TResult)

Parametri

function

Func<TResult>

Delegato della funzione che restituisce il risultato futuro da rendere disponibile tramite l'attività.

Restituisce

Task<TResult>

Attività avviata.

Eccezioni

ArgumentNullException

Il valore dell'argomento function è null.

Commenti

La chiamata StartNew è funzionalmente equivalente alla creazione di un'attività usando uno dei Task<TResult> costruttori e quindi chiamando il metodo per pianificarla per l'esecuzione Start .

Tuttavia, a meno che la creazione e la pianificazione non siano separate, StartNew è l'approccio consigliato sia per semplicità che per le prestazioni.

Vedi anche

• Task Parallel Library (TPL)
• Uso di TPL con altri modelli asincroni

StartNew(Func<TResult>, CancellationToken)

Origine:

FutureFactory.cs

Crea e avvia un'attività.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Func<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), cancellationToken As CancellationToken) As Task(Of TResult)

Parametri

function

Func<TResult>

Delegato della funzione che restituisce il risultato futuro da rendere disponibile tramite l'attività.

cancellationToken

CancellationToken

Token di annullamento che verrà assegnato alla nuova attività.

Restituisce

Task<TResult>

Attività avviata.

Eccezioni

ObjectDisposedException

L'origine del token di annullamento che ha creato cancellationToken è già stata eliminata.

ArgumentNullException

Il valore dell'argomento function è null.

Commenti

La chiamata StartNew è funzionalmente equivalente alla creazione di un'attività usando uno dei Task<TResult> costruttori e quindi chiamando il metodo per pianificarla per l'esecuzione Start .

Tuttavia, a meno che la creazione e la pianificazione non siano separate, StartNew è l'approccio consigliato sia per semplicità che per le prestazioni.

Vedi anche

• Task Parallel Library (TPL)
• Uso di TPL con altri modelli asincroni

StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)

Origine:

FutureFactory.cs

Crea e avvia un'attività.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

Parametri

function

Func<Object,TResult>

Delegato della funzione che restituisce il risultato futuro da rendere disponibile tramite l'attività.

state

Object

Oggetto contenente i dati che devono essere usati dal delegato function.

cancellationToken

CancellationToken

Token di annullamento che verrà assegnato alla nuova attività.

creationOptions

TaskCreationOptions

Uno dei valori di enumerazione che controlla il comportamento dell'attività creata.

scheduler

TaskScheduler

Utilità di pianificazione usata per pianificare l'attività creata.

Restituisce

Task<TResult>

Attività avviata.

Eccezioni

ObjectDisposedException

L'origine del token di annullamento che ha creato cancellationToken è già stata eliminata.

ArgumentNullException

Il valore dell'argomento function è null.

-oppure-

Il valore dell'argomento scheduler è null.

ArgumentOutOfRangeException

Nel parametro creationOptions è stato specificato un valore non valido.

Commenti

La chiamata StartNew è equivalente alla creazione di un'attività usando uno dei Task<TResult> costruttori e quindi chiamando il Start metodo per pianificarlo per l'esecuzione.

Tuttavia, a meno che non sia necessario separare la creazione e la pianificazione, StartNew è l'approccio consigliato per semplicità e prestazioni.

Vedi anche

• Task Parallel Library (TPL)
• Uso di TPL con altri modelli asincroni