TaskFactory<TResult>.StartNew Método

Definição

Namespace:

System.Threading.Tasks

Assembly:

System.Threading.Tasks.dll

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Cria e inicia uma tarefa.

Sobrecargas

StartNew(Func<Object,TResult>, Object, CancellationToken)	Cria e inicia uma tarefa.
StartNew(Func<Object,TResult>, Object, TaskCreationOptions)	Cria e inicia uma tarefa.
StartNew(Func<TResult>, TaskCreationOptions)	Cria e inicia uma tarefa.
StartNew(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)	Cria e inicia uma tarefa.
StartNew(Func<Object,TResult>, Object)	Cria e inicia uma tarefa.
StartNew(Func<TResult>)	Cria e inicia uma tarefa.
StartNew(Func<TResult>, CancellationToken)	Cria e inicia uma tarefa.
StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	Cria e inicia uma tarefa.

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

Cria e inicia uma tarefa.

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);

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)

Parâmetros

function

Func<Object,TResult>

Um delegado de função que retorna o resultado futuro que estará disponível por meio da tarefa.

state

Object

Um objeto que contém dados a serem usados pelo delegado function.

cancellationToken

CancellationToken

O token de cancelamento que será atribuído à nova tarefa.

Retornos

Task<TResult>

A tarefa iniciada.

Exceções

ObjectDisposedException

A origem do token de cancelamento que criou cancellationToken já foi descartada.

ArgumentNullException

O argumento function é null.

Comentários

A chamada StartNew é funcionalmente equivalente à criação de uma tarefa usando um dos Task<TResult> construtores e, em seguida, chamando o Start método para agendá-lo para execução.

No entanto, a menos que a criação e o agendamento devem ser separados, StartNew é a abordagem recomendada para simplicidade e desempenho.

Confira também

• Biblioteca de tarefas paralelas (TPL)
• Usando TPL com outros padrões assíncronos

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

Cria e inicia uma tarefa.

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);

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)

Parâmetros

function

Func<Object,TResult>

Um delegado de função que retorna o resultado futuro que estará disponível por meio da tarefa.

state

Object

Um objeto que contém dados a serem usados pelo delegado function.

creationOptions

TaskCreationOptions

Um dos valores de enumeração que controla o comportamento da tarefa criada.

Retornos

Task<TResult>

A tarefa iniciada.

Exceções

ArgumentNullException

O argumento function é null.

ArgumentOutOfRangeException

O parâmetro creationOptions especifica um valor inválido.

Comentários

A chamada StartNew é funcionalmente equivalente à criação de uma tarefa usando um dos Task<TResult> construtores e, em seguida, chamando o método para agende-o Start para execução.

No entanto, a menos que a criação e o agendamento devem ser separados, StartNew é a abordagem recomendada para simplicidade e desempenho.

Confira também

• Biblioteca de tarefas paralelas (TPL)
• Usando TPL com outros padrões assíncronos

StartNew(Func<TResult>, TaskCreationOptions)

Cria e inicia uma tarefa.

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)

Parâmetros

function

Func<TResult>

Um delegado de função que retorna o resultado futuro que estará disponível por meio da tarefa.

creationOptions

TaskCreationOptions

Um dos valores de enumeração que controla o comportamento da tarefa criada.

Retornos

Task<TResult>

O Task<TResult> iniciado.

Exceções

ArgumentNullException

O argumento function é null.

ArgumentOutOfRangeException

O parâmetro creationOptions especifica um valor inválido.

Comentários

A chamada StartNew é funcionalmente equivalente à criação de uma tarefa usando um dos Task<TResult> construtores e, em seguida, chamando o Start método para agendá-lo para execução.

No entanto, a menos que a criação e o agendamento devem ser separados, StartNew é a abordagem recomendada para simplicidade e desempenho.

Confira também

• Biblioteca de tarefas paralelas (TPL)
• Usando TPL com outros padrões assíncronos

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

Cria e inicia uma tarefa.

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)

Parâmetros

function

Func<TResult>

Um delegado de função que retorna o resultado futuro que estará disponível por meio da tarefa.

cancellationToken

CancellationToken

O token de cancelamento que será atribuído à nova tarefa.

creationOptions

TaskCreationOptions

Um dos valores de enumeração que controla o comportamento da tarefa criada.

scheduler

TaskScheduler

O agendador de tarefas é usado para agendar a tarefa criada.

Retornos

Task<TResult>

A tarefa iniciada.

Exceções

ObjectDisposedException

A origem do token de cancelamento que criou cancellationToken já foi descartada.

ArgumentNullException

O argumento function é null.

- ou - O argumento scheduler é null.

ArgumentOutOfRangeException

O parâmetro creationOptions especifica um valor inválido.

Comentários

A chamada StartNew é funcionalmente equivalente à criação de uma tarefa usando um dos Task<TResult> construtores e, em seguida, chamando o método para agende-o Start para execução.

No entanto, a menos que a criação e o agendamento devem ser separados, StartNew é a abordagem recomendada para simplicidade e desempenho.

Confira também

• Biblioteca de tarefas paralelas (TPL)
• Usando TPL com outros padrões assíncronos

StartNew(Func<Object,TResult>, Object)

Cria e inicia uma tarefa.

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);

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)

Parâmetros

function

Func<Object,TResult>

Um delegado de função que retorna o resultado futuro que estará disponível por meio da tarefa.

state

Object

Um objeto que contém dados a serem usados pelo delegado function.

Retornos

Task<TResult>

A tarefa iniciada.

Exceções

ArgumentNullException

O argumento function é null.

Comentários

A chamada StartNew é funcionalmente equivalente à criação de uma tarefa usando um dos Task<TResult> construtores e, em seguida, chamando o Start método para agendá-lo para execução.

No entanto, a menos que a criação e o agendamento devem ser separados, StartNew é a abordagem recomendada para simplicidade e desempenho.

Confira também

• Biblioteca de tarefas paralelas (TPL)
• Usando TPL com outros padrões assíncronos

StartNew(Func<TResult>)

Cria e inicia uma tarefa.

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)

Parâmetros

function

Func<TResult>

Um delegado de função que retorna o resultado futuro que estará disponível por meio da tarefa.

Retornos

Task<TResult>

A tarefa iniciada.

Exceções

ArgumentNullException

O argumento function é null.

Comentários

A chamada StartNew é funcionalmente equivalente à criação de uma tarefa usando um dos Task<TResult> construtores e, em seguida, chamar o Start método para agendá-lo para execução.

No entanto, a menos que a criação e o agendamento devem ser separados, StartNew é a abordagem recomendada para simplicidade e desempenho.

Confira também

• Biblioteca de tarefas paralelas (TPL)
• Usando TPL com outros padrões assíncronos

StartNew(Func<TResult>, CancellationToken)

Cria e inicia uma tarefa.

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)

Parâmetros

function

Func<TResult>

Um delegado de função que retorna o resultado futuro que estará disponível por meio da tarefa.

cancellationToken

CancellationToken

O token de cancelamento que será atribuído à nova tarefa.

Retornos

Task<TResult>

A tarefa iniciada.

Exceções

ObjectDisposedException

A origem do token de cancelamento que criou cancellationToken já foi descartada.

ArgumentNullException

O argumento function é null.

Comentários

A chamada StartNew é funcionalmente equivalente à criação de uma tarefa usando um dos Task<TResult> construtores e, em seguida, chamando o Start método para agendá-lo para execução.

No entanto, a menos que a criação e o agendamento devem ser separados, StartNew é a abordagem recomendada para simplicidade e desempenho.

Confira também

• Biblioteca de tarefas paralelas (TPL)
• Usando TPL com outros padrões assíncronos

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

Cria e inicia uma tarefa.

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);

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)

Parâmetros

function

Func<Object,TResult>

Um delegado de função que retorna o resultado futuro que estará disponível por meio da tarefa.

state

Object

Um objeto que contém dados a serem usados pelo delegado function.

cancellationToken

CancellationToken

O token de cancelamento que será atribuído à nova tarefa.

creationOptions

TaskCreationOptions

Um dos valores de enumeração que controla o comportamento da tarefa criada.

scheduler

TaskScheduler

O agendador de tarefas é usado para agendar a tarefa criada.

Retornos

Task<TResult>

A tarefa iniciada.

Exceções

ObjectDisposedException

A origem do token de cancelamento que criou cancellationToken já foi descartada.

ArgumentNullException

O argumento function é null.

- ou - O argumento scheduler é null.

ArgumentOutOfRangeException

O parâmetro creationOptions especifica um valor inválido.

Comentários

A chamada StartNew é funcionalmente equivalente à criação de uma tarefa usando um dos Task<TResult> construtores e, em seguida, chamando o método para agende-o Start para execução.

No entanto, a menos que a criação e o agendamento devem ser separados, StartNew é a abordagem recomendada para simplicidade e desempenho.

Confira também

• Biblioteca de tarefas paralelas (TPL)
• Usando TPL com outros padrões assíncronos