Task<TResult> Construtores

Definição

Espaço de Nomes:: System.Threading.Tasks

Assemblagens:: mscorlib.dll, System.Threading.Tasks.dll

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Threading.Tasks.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa um novo Task<TResult> objeto.

Sobrecargas

Name	Description
Task<TResult>(Func<TResult>)	Inicializa um novo Task<TResult> com a função especificada.
Task<TResult>(Func<Object,TResult>, Object)	Inicializa um novo Task<TResult> com a função e o estado especificados.
Task<TResult>(Func<TResult>, CancellationToken)	Inicializa um novo Task<TResult> com a função especificada.
Task<TResult>(Func<TResult>, TaskCreationOptions)	Inicializa um novo Task<TResult> com as funções e opções de criação especificadas.
Task<TResult>(Func<Object,TResult>, Object, CancellationToken)	Inicializa um novo Task<TResult> com a ação, estado e opções especificados.
Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions)	Inicializa um novo Task<TResult> com a ação, estado e opções especificados.
Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions)	Inicializa um novo Task<TResult> com as funções e opções de criação especificadas.
Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions)	Inicializa um novo Task<TResult> com a ação, estado e opções especificados.

Task<TResult>(Func<TResult>)

Origem:: Future.cs

Origem:: Task_T.cs

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 executar na tarefa. Quando a função estiver concluída, a propriedade da Result tarefa será definida para devolver o valor do resultado da função.

Exceções

ArgumentNullException

O function argumento é null.

ArgumentException

O function argumento é null.

Exemplos

O exemplo seguinte conta o número aproximado de palavras em ficheiros de texto que representam livros publicados. Cada tarefa é responsável por abrir um ficheiro, ler todo o seu 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 foram concluídas antes de mostrar a contagem de palavras de cada livro na consola.

A instanciação de objetos está separada da execução de objetos neste exemplo para que o exemplo possa garantir que cada ficheiro existe. Se não o fizerem, mostra o nome do ficheiro em falta. Caso contrário, chama o Task.Start método para lançar 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 de um ou mais caracteres de espaço em branco. Assume que o número total de correspondências é igual ao número aproximado de palavras.

Observações

Este construtor só deve ser usado em cenários avançados onde é necessário separar a criação e o início da tarefa.

Se uma tarefa sem ação for necessária apenas para que o consumidor de uma API tenha algo para esperar, deve ser usado a TaskCompletionSource<TResult> .

Ver também

Aplica-se a

Task<TResult>(Func<Object,TResult>, Object)

Origem:: Future.cs

Origem:: Task_T.cs

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

function: Func<Object,TResult>

O delegado que representa o código a executar na tarefa. Quando a função estiver concluída, a propriedade da Result tarefa será definida para devolver o valor do resultado da função.

state: Object

Um objeto que representa dados a serem usados pela ação.

Exceções

ArgumentNullException

O function argumento é null.

ArgumentException

O function argumento é null.

Observações

Em vez de chamar este construtor, a forma mais comum de instanciar um Task<TResult> objeto e lançar uma tarefa é chamando o método estático TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object) . A única vantagem oferecida por este construtor é permitir que a instância de objetos seja separada da invocação de tarefas.

Ver também

Aplica-se a

Task<TResult>(Func<TResult>, CancellationToken)

Origem:: Future.cs

Origem:: Task_T.cs

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 executar na tarefa. Quando a função estiver concluída, a propriedade da Result tarefa será definida para devolver o valor do resultado da função.

cancellationToken: CancellationToken

A CancellationToken ser atribuída a esta tarefa.

Exceções

ObjectDisposedException

O CancellationTokenSource que foi criado cancellationToken já foi eliminado.

ArgumentNullException

O function argumento é null.

ArgumentException

O function argumento é null.

Observações

Em vez de chamar este construtor, a forma mais comum de instanciar um Task<TResult> objeto e lançar uma tarefa é chamando os métodos estáticos Task.Run<TResult>(Func<TResult>, CancellationToken) e TaskFactory<TResult>.StartNew(Func<TResult>, CancellationToken) de . A única vantagem oferecida por este construtor é permitir que a instância de objetos seja separada da invocação de tarefas.

Ver também

Aplica-se a

Task<TResult>(Func<TResult>, TaskCreationOptions)

Origem:: Future.cs

Origem:: Task_T.cs

Origem:: Future.cs

Origem:: Future.cs

Origem:: Future.cs

Inicializa um novo Task<TResult> com as funções e opções de criação especificadas.

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 executar na tarefa. Quando a função estiver concluída, a propriedade da Result tarefa será definida para devolver o valor do resultado da função.

creationOptions: TaskCreationOptions

É TaskCreationOptions usado para personalizar o comportamento da tarefa.

Exceções

ArgumentOutOfRangeException

O creationOptions argumento especifica um valor inválido para TaskCreationOptions.

ArgumentNullException

O function argumento é null.

ArgumentException

O function argumento é null.

Observações

Em vez de chamar este construtor, a forma mais comum de instanciar um Task<TResult> objeto e lançar uma tarefa é chamando o método estático TaskFactory<TResult>.StartNew(Func<TResult>, TaskCreationOptions) . A única vantagem oferecida por este construtor é permitir que a instância de objetos seja separada da invocação de tarefas.

Ver também

Aplica-se a

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

Origem:: Future.cs

Origem:: Task_T.cs

Origem:: Future.cs

Origem:: Future.cs

Origem:: Future.cs

Inicializa um novo Task<TResult> com a ação, estado e 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

function: Func<Object,TResult>

O delegado que representa o código a executar na tarefa. Quando a função estiver concluída, a propriedade da Result tarefa será definida para devolver o valor do resultado da função.

state: Object

Um objeto que representa dados a serem usados pela função.

cancellationToken: CancellationToken

A ser CancellationToken atribuída à nova tarefa.

Exceções

ObjectDisposedException

O CancellationTokenSource que foi criado cancellationToken já foi eliminado.

ArgumentNullException

O function argumento é null.

ArgumentException

O function argumento é null.

Observações

Em vez de chamar este construtor, a forma mais comum de instanciar um Task<TResult> objeto e lançar uma tarefa é chamando o método estático TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken) . A única vantagem oferecida por este construtor é permitir que a instância de objetos seja separada da invocação de tarefas.

Ver também

Aplica-se a

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

Origem:: Future.cs

Origem:: Task_T.cs

Origem:: Future.cs

Origem:: Future.cs

Origem:: Future.cs

Inicializa um novo Task<TResult> com a ação, estado e 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

function: Func<Object,TResult>

O delegado que representa o código a executar na tarefa. Quando a função estiver concluída, a propriedade da Result tarefa será definida para devolver o valor do resultado da função.

state: Object

Um objeto que representa dados a serem usados pela função.

creationOptions: TaskCreationOptions

É TaskCreationOptions usado para personalizar o comportamento da tarefa.

Exceções

ArgumentOutOfRangeException

O creationOptions argumento especifica um valor inválido para TaskCreationOptions.

ArgumentNullException

O function argumento é null.

ArgumentException

O function argumento é null.

Observações

Em vez de chamar este construtor, a forma mais comum de instanciar um Task<TResult> objeto e lançar uma tarefa é chamando o método estático TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, TaskCreationOptions) . A única vantagem oferecida por este construtor é permitir que a instância de objetos seja separada da invocação de tarefas.

Ver também

Aplica-se a

Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions)

Origem:: Future.cs

Origem:: Task_T.cs

Origem:: Future.cs

Origem:: Future.cs

Origem:: Future.cs

Inicializa um novo Task<TResult> com as funções e opções de criação especificadas.

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 executar na tarefa. Quando a função estiver concluída, a propriedade da Result tarefa será definida para devolver o valor do resultado da função.

cancellationToken: CancellationToken

O CancellationToken que será atribuído à nova tarefa.

creationOptions: TaskCreationOptions

É TaskCreationOptions usado para personalizar o comportamento da tarefa.

Exceções

ObjectDisposedException

O CancellationTokenSource que foi criado cancellationToken já foi eliminado.

ArgumentOutOfRangeException

O creationOptions argumento especifica um valor inválido para TaskCreationOptions.

ArgumentNullException

O function argumento é null.

ArgumentException

O function argumento é null.

Observações

Em vez de chamar este construtor, a forma mais comum de instanciar um Task<TResult> objeto e lançar uma tarefa é chamando o método estático TaskFactory.StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler) . A única vantagem oferecida por este construtor é permitir que a instância de objetos seja separada da invocação de tarefas.

Ver também

Aplica-se a

Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions)

Origem:: Future.cs

Origem:: Task_T.cs

Origem:: Future.cs

Origem:: Future.cs

Origem:: Future.cs

Inicializa um novo Task<TResult> com a ação, estado e 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

function: Func<Object,TResult>

O delegado que representa o código a executar na tarefa. Quando a função estiver concluída, a propriedade da Result tarefa será definida para devolver o valor do resultado da função.

state: Object

Um objeto que representa dados a serem usados pela função.

cancellationToken: CancellationToken

A ser CancellationToken atribuída à nova tarefa.

creationOptions: TaskCreationOptions

É TaskCreationOptions usado para personalizar o comportamento da tarefa.

Exceções

ObjectDisposedException

O CancellationTokenSource que foi criado cancellationToken já foi eliminado.

ArgumentOutOfRangeException

O creationOptions argumento especifica um valor inválido para TaskCreationOptions.

ArgumentNullException

O function argumento é null.

ArgumentException

O function argumento é null.

Observações

Em vez de chamar este construtor, a forma mais comum de instanciar um Task<TResult> objeto e lançar uma tarefa é chamando o método estático TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler) . A única vantagem oferecida por este construtor é permitir que a instância de objetos seja separada da invocação de tarefas.

Ver também

Aplica-se a

Comentários

Esta página foi útil?