Task<TResult> Construtores
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicializa um novo objeto Task<TResult>.
Sobrecargas
Task<TResult>(Func<TResult>)
- Origem:
- Future.cs
- Origem:
- Future.cs
- Origem:
- Future.cs
Inicializa um novo Task<TResult> com a função especificada.
public:
Task(Func<TResult> ^ function);public Task (Func<TResult> function);new System.Threading.Tasks.Task<'Result> : Func<'Result> -> System.Threading.Tasks.Task<'Result>Public Sub New (function As Func(Of TResult))Parâmetros
- function
- Func<TResult>
O delegado que representa o código a ser executado na tarefa. Quando a função for concluída, a propriedade Result da tarefa será definida para retornar o valor do resultado da função.
Exceções
O argumento function é null.
O argumento function é null.
Exemplos
O exemplo a seguir conta o número aproximado de palavras em arquivos de texto que representam livros publicados. Cada tarefa é responsável por abrir um arquivo, ler todo o conteúdo de forma assíncrona e calcular a contagem de palavras usando uma expressão regular. O Task.WaitAll(Task[]) método é chamado para garantir que todas as tarefas tenham sido concluídas antes de exibir a contagem de palavras de cada livro no console.
A instanciação de objeto é separada da execução do objeto neste exemplo para que o exemplo possa garantir que cada arquivo exista. Se não o fizerem, ele exibirá o nome do arquivo ausente. Caso contrário, ele chama o Task.Start método para iniciar cada tarefa.
using System;
using System.IO;
using System.Text.RegularExpressions;
using System.Threading.Tasks;
public class Example
{
public static async Task Main()
{
string pattern = @"\p{P}*\s+";
string[] titles = { "Sister Carrie", "The Financier" };
Task<int>[] tasks = new Task<int>[titles.Length];
for (int ctr = 0; ctr < titles.Length; ctr++) {
string s = titles[ctr];
tasks[ctr] = new Task<int>( () => {
// Number of words.
int nWords = 0;
// Create filename from title.
string fn = s + ".txt";
StreamReader sr = new StreamReader(fn);
string input = sr.ReadToEndAsync().Result;
sr.Close();
nWords = Regex.Matches(input, pattern).Count;
return nWords;
} );
}
// Ensure files exist before launching tasks.
bool allExist = true;
foreach (var title in titles) {
string fn = title + ".txt";
if (! File.Exists(fn)) {
allExist = false;
Console.WriteLine("Cannot find '{0}'", fn);
break;
}
}
// Launch tasks
if (allExist) {
foreach (var t in tasks)
t.Start();
await Task.WhenAll(tasks);
Console.WriteLine("Word Counts:\n");
for (int ctr = 0; ctr < titles.Length; ctr++)
Console.WriteLine("{0}: {1,10:N0} words", titles[ctr], tasks[ctr].Result);
}
}
}
// The example displays the following output:
// Sister Carrie: 159,374 words
// The Financier: 196,362 words
Imports System.IO
Imports System.Text.RegularExpressions
Imports System.Threading.Tasks
Module Example
Public Sub Main()
Dim pattern As String = "\p{P}*\s+"
Dim titles() As String = { "Sister Carrie",
"The Financier" }
Dim tasks(titles.Length - 1) As Task(Of Integer)
For ctr As Integer = 0 To titles.Length - 1
Dim s As String = titles(ctr)
tasks(ctr) = New Task(Of Integer)( Function()
' Number of words.
Dim nWords As Integer = 0
' Create filename from title.
Dim fn As String = s + ".txt"
Dim sr As New StreamReader(fn)
Dim input As String = sr.ReadToEndAsync().Result
sr.Close()
nWords = Regex.Matches(input, pattern).Count
Return nWords
End Function)
Next
' Ensure files exist before launching tasks.
Dim allExist As Boolean = True
For Each title In titles
Dim fn As String = title + ".txt"
If Not File.Exists(fn) Then
allExist = false
Console.WriteLine("Cannot find '{0}'", fn)
Exit For
End If
Next
' Launch tasks
If allExist Then
For Each t in tasks
t.Start()
Next
Task.WaitAll(tasks)
Console.WriteLine("Word Counts:")
Console.WriteLine()
For ctr As Integer = 0 To titles.Length - 1
Console.WriteLine("{0}: {1,10:N0} words", titles(ctr), tasks(ctr).Result)
Next
End If
End Sub
End Module
' The example displays the following output:
' Sister Carrie: 159,374 words
' The Financier: 196,362 words
O padrão \p{P}*\s+ de expressão regular corresponde a zero, um ou mais caracteres de pontuação seguidos por um ou mais caracteres de espaço em branco. Ele pressupõe que o número total de correspondências é igual à contagem aproximada de palavras.
Comentários
Esse construtor só deve ser usado em cenários avançados em que é necessário que a criação e o início da tarefa sejam separados.
Em vez de chamar esse construtor, a maneira mais comum de instanciar um Task<TResult> objeto e iniciar uma tarefa é chamando os métodos e TaskFactory<TResult>.StartNew(Func<TResult>) estáticosTask.Run<TResult>(Func<TResult>).
Se uma tarefa sem ação for necessária apenas para o consumidor de uma API ter algo a aguardar, um TaskCompletionSource<TResult> deverá ser usado.
Confira também
Aplica-se a
Task<TResult>(Func<Object,TResult>, Object)
- Origem:
- Future.cs
- Origem:
- Future.cs
- Origem:
- Future.cs
Inicializa um novo Task<TResult> com a função e o estado especificados.
public:
Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state);public Task (Func<object,TResult> function, object state);public Task (Func<object?,TResult> function, object? state);new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj -> System.Threading.Tasks.Task<'Result>Public Sub New (function As Func(Of Object, TResult), state As Object)Parâmetros
O delegado que representa o código a ser executado na tarefa. Quando a função for concluída, a propriedade Result da tarefa será definida para retornar o valor do resultado da função.
- state
- Object
Um objeto que representa dados a serem usados pela ação.
Exceções
O argumento function é null.
O argumento function é null.
Comentários
Em vez de chamar esse construtor, a maneira mais comum de instanciar um Task<TResult> objeto e iniciar uma tarefa é chamando o método estático TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object) . A única vantagem oferecida por esse construtor é que ele permite que a instanciação de objeto seja separada da invocação de tarefa.
Confira também
Aplica-se a
Task<TResult>(Func<TResult>, CancellationToken)
- Origem:
- Future.cs
- Origem:
- Future.cs
- Origem:
- Future.cs
Inicializa um novo Task<TResult> com a função especificada.
public:
Task(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken);public Task (Func<TResult> function, System.Threading.CancellationToken cancellationToken);new System.Threading.Tasks.Task<'Result> : Func<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>Public Sub New (function As Func(Of TResult), cancellationToken As CancellationToken)Parâmetros
- function
- Func<TResult>
O delegado que representa o código a ser executado na tarefa. Quando a função for concluída, a propriedade Result da tarefa será definida para retornar o valor do resultado da função.
- cancellationToken
- CancellationToken
O CancellationToken a ser atribuído a essa tarefa.
Exceções
O CancellationTokenSource que criou cancellationToken já foi descartado.
O argumento function é null.
O argumento function é null.
Comentários
Em vez de chamar esse construtor, a maneira mais comum de instanciar um Task<TResult> objeto e iniciar uma tarefa é chamando os métodos e TaskFactory<TResult>.StartNew(Func<TResult>, CancellationToken) estáticosTask.Run<TResult>(Func<TResult>, CancellationToken). A única vantagem oferecida por esse construtor é que ele permite que a instanciação de objeto seja separada da invocação de tarefa.
Confira também
Aplica-se a
Task<TResult>(Func<TResult>, TaskCreationOptions)
- Origem:
- Future.cs
- Origem:
- Future.cs
- Origem:
- Future.cs
Inicializa um novo Task<TResult> com a função especificada e opções de criação.
public:
Task(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);public Task (Func<TResult> function, System.Threading.Tasks.TaskCreationOptions creationOptions);new System.Threading.Tasks.Task<'Result> : Func<'Result> * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>Public Sub New (function As Func(Of TResult), creationOptions As TaskCreationOptions)Parâmetros
- function
- Func<TResult>
O delegado que representa o código a ser executado na tarefa. Quando a função for concluída, a propriedade Result da tarefa será definida para retornar o valor do resultado da função.
- creationOptions
- TaskCreationOptions
O TaskCreationOptions usado para personalizar o comportamento da tarefa.
Exceções
O argumento creationOptions especifica um valor inválido para TaskCreationOptions.
O argumento function é null.
O argumento function é null.
Comentários
Em vez de chamar esse construtor, a maneira mais comum de instanciar um Task<TResult> objeto e iniciar uma tarefa é chamando o método estático TaskFactory<TResult>.StartNew(Func<TResult>, TaskCreationOptions) . A única vantagem oferecida por esse construtor é que ele permite que a instanciação de objeto seja separada da invocação de tarefa.
Confira também
Aplica-se a
Task<TResult>(Func<Object,TResult>, Object, CancellationToken)
- Origem:
- Future.cs
- Origem:
- Future.cs
- Origem:
- Future.cs
Inicializa um novo Task<TResult> com a ação, o estado e as opções especificados.
public:
Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken);public Task (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken);public Task (Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken);new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>Public Sub New (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken)Parâmetros
O delegado que representa o código a ser executado na tarefa. Quando a função for concluída, a propriedade Result da tarefa será definida para retornar o valor do resultado da função.
- state
- Object
Um objeto que representa dados a serem usados pela função.
- cancellationToken
- CancellationToken
O CancellationToken a ser atribuído a essa nova tarefa.
Exceções
O CancellationTokenSource que criou cancellationToken já foi descartado.
O argumento function é null.
O argumento function é null.
Comentários
Em vez de chamar esse construtor, a maneira mais comum de instanciar um Task<TResult> objeto e iniciar uma tarefa é chamando o método estático TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken) . A única vantagem oferecida por esse construtor é que ele permite que a instanciação de objeto seja separada da invocação de tarefa.
Confira também
Aplica-se a
Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions)
- Origem:
- Future.cs
- Origem:
- Future.cs
- Origem:
- Future.cs
Inicializa um novo Task<TResult> com a ação, o estado e as opções especificados.
public:
Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);public Task (Func<object,TResult> function, object state, System.Threading.Tasks.TaskCreationOptions creationOptions);public Task (Func<object?,TResult> function, object? state, System.Threading.Tasks.TaskCreationOptions creationOptions);new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>Public Sub New (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions)Parâmetros
O delegado que representa o código a ser executado na tarefa. Quando a função for concluída, a propriedade Result da tarefa será definida para retornar o valor do resultado da função.
- state
- Object
Um objeto que representa dados a serem usados pela função.
- creationOptions
- TaskCreationOptions
O TaskCreationOptions usado para personalizar o comportamento da tarefa.
Exceções
O argumento creationOptions especifica um valor inválido para TaskCreationOptions.
O argumento function é null.
O argumento function é null.
Comentários
Em vez de chamar esse construtor, a maneira mais comum de instanciar um Task<TResult> objeto e iniciar uma tarefa é chamando o método estático TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, TaskCreationOptions) . A única vantagem oferecida por esse construtor é que ele permite que a instanciação de objeto seja separada da invocação de tarefa.
Confira também
Aplica-se a
Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions)
- Origem:
- Future.cs
- Origem:
- Future.cs
- Origem:
- Future.cs
Inicializa um novo Task<TResult> com a função especificada e opções de criação.
public:
Task(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions);public Task (Func<TResult> function, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);new System.Threading.Tasks.Task<'Result> : Func<'Result> * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>Public Sub New (function As Func(Of TResult), cancellationToken As CancellationToken, creationOptions As TaskCreationOptions)Parâmetros
- function
- Func<TResult>
O delegado que representa o código a ser executado na tarefa. Quando a função for concluída, a propriedade Result da tarefa será definida para retornar o valor do resultado da função.
- cancellationToken
- CancellationToken
O CancellationToken que será atribuído a nova tarefa.
- creationOptions
- TaskCreationOptions
O TaskCreationOptions usado para personalizar o comportamento da tarefa.
Exceções
O CancellationTokenSource que criou cancellationToken já foi descartado.
O argumento creationOptions especifica um valor inválido para TaskCreationOptions.
O argumento function é null.
O argumento function é null.
Comentários
Em vez de chamar esse construtor, a maneira mais comum de instanciar um Task<TResult> objeto e iniciar uma tarefa é chamando o método estático TaskFactory.StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler) . A única vantagem oferecida por esse construtor é que ele permite que a instanciação de objeto seja separada da invocação de tarefa.
Confira também
Aplica-se a
Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions)
- Origem:
- Future.cs
- Origem:
- Future.cs
- Origem:
- Future.cs
Inicializa um novo Task<TResult> com a ação, o estado e as opções especificados.
public:
Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions);public Task (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);public Task (Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>Public Sub New (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions)Parâmetros
O delegado que representa o código a ser executado na tarefa. Quando a função for concluída, a propriedade Result da tarefa será definida para retornar o valor do resultado da função.
- state
- Object
Um objeto que representa dados a serem usados pela função.
- cancellationToken
- CancellationToken
O CancellationToken a ser atribuído a essa nova tarefa.
- creationOptions
- TaskCreationOptions
O TaskCreationOptions usado para personalizar o comportamento da tarefa.
Exceções
O CancellationTokenSource que criou cancellationToken já foi descartado.
O argumento creationOptions especifica um valor inválido para TaskCreationOptions.
O argumento function é null.
O argumento function é null.
Comentários
Em vez de chamar esse construtor, a maneira mais comum de instanciar um Task<TResult> objeto e iniciar uma tarefa é chamando o método estático TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler) . A única vantagem oferecida por esse construtor é que ele permite que a instanciação de objeto seja separada da invocação de tarefa.
Confira também
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de