Partilhar via


TaskFactory<TResult>.StartNew Método

Definição

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

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

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

Aplica-se a

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

O argumento function é null.

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

Aplica-se a

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

O argumento function é null.

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

Aplica-se a

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

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

O argumento function é null.

- ou - O argumento scheduler é null.

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

Aplica-se a

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

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

Aplica-se a

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

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

Aplica-se a

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

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

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

Aplica-se a

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

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

O argumento function é null.

- ou - O argumento scheduler é null.

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

Aplica-se a