TaskFactory<TResult> Classe

Referência

Definição

Namespace:: System.Threading.Tasks

Assembly:: System.Threading.Tasks.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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.

Fornece suporte para criação e agendamento de objetos Task<TResult>.

generic <typename TResult>
public ref class TaskFactory

public class TaskFactory<TResult>

type TaskFactory<'Result> = class

Public Class TaskFactory(Of TResult)

Parâmetros de tipo

TResult

O valor retornado dos objetos Task<TResult> criados pelos métodos dessa classe.

Herança: Object
TaskFactory<TResult>

Exemplos

O exemplo a seguir usa a propriedade estática Factory para fazer duas chamadas ao TaskFactory<TResult>.StartNew método. A primeira tarefa retorna uma matriz de cadeia de caracteres que é preenchida com os nomes dos arquivos no diretório MyDocuments do usuário, enquanto a segunda retorna uma matriz de cadeia de caracteres que é preenchida com os nomes de subdiretórios do diretório MyDocuments do usuário. Em seguida, ele chama o TaskFactory.ContinueWhenAll(Task[], Action<Task[]>) método, que exibe informações sobre o número de arquivos e diretórios nas matrizes retornadas pelas duas tarefas após a conclusão da execução.

using System;
using System.IO;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      Task<string[]>[] tasks = new Task<string[]>[2];
      String docsDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);

      tasks[0] = Task<string[]>.Factory.StartNew( () => Directory.GetFiles(docsDirectory));
      tasks[1] = Task<string[]>.Factory.StartNew( () => Directory.GetDirectories(docsDirectory));

      Task.Factory.ContinueWhenAll(tasks, completedTasks => {
                                             Console.WriteLine("{0} contains: ", docsDirectory);
                                             Console.WriteLine("   {0} subdirectories", tasks[1].Result.Length);
                                             Console.WriteLine("   {0} files", tasks[0].Result.Length);
                                          } );
   }
}
// The example displays output like the following:
//       C:\Users\<username>\Documents contains:
//          24 subdirectories
//          16 files

Imports System.IO
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim tasks(1) As Task(Of String())
      Dim docsDirectory As String = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments)
      
      tasks(0) = Task(Of String()).Factory.StartNew( Function()Directory.GetFiles(docsDirectory) )
''                                        End Sub )
      tasks(1) = Task(Of String()).Factory.StartNew( Function() Directory.GetDirectories(docsDirectory) )
''                                        End Sub )
      Task.Factory.ContinueWhenAll(tasks, Sub(completedTasks)
                                             Console.WriteLine("{0} contains: ", docsDirectory)
                                             Console.WriteLine("   {0} subdirectories", tasks(1).Result.Length)
                                             Console.WriteLine("   {0} files", tasks(0).Result.Length)
                                          End Sub)
   End Sub
End Module
' The example displays output like the following:
'       C:\Users\<username>\Documents contains:
'          24 subdirectories
'          16 files

Comentários

O .NET fornece duas fábricas para criar e agendar tarefas:

A TaskFactory classe, que cria Task e Task<TResult> objetos.
A TaskFactory<TResult> classe, que cria Task<TResult> objetos.

A TaskFactory<TResult> classe permite que você faça o seguinte:

Crie uma tarefa e inicie-a imediatamente chamando o StartNew método. Você pode chamar as sobrecargas desse método para criar e executar uma tarefa que exige argumentos não padrão.

Aviso

Começando com .NET Framework 4.5, o Task.Run método fornece a maneira mais fácil de criar uma tarefa com valores de configuração padrão e iniciá-la imediatamente.
Crie uma tarefa que comece quando qualquer uma das tarefas em uma matriz for concluída chamando o método ou ContinueWhenAny o ContinueWhenAny método.
Crie uma tarefa que comece quando todas as tarefas em uma matriz tiverem sido concluídas chamando o método ou ContinueWhenAll o ContinueWhenAll método.

A propriedade estática Task<TResult>.Factory retorna um objeto padrão TaskFactory<TResult> . Você também pode chamar um dos construtores de TaskFactory<TResult> classe para configurar os Task<TResult> objetos que a TaskFactory<TResult> classe cria. O exemplo a seguir configura um novo TaskFactory<TResult> objeto para criar tarefas que têm um token de cancelamento especificado, opções de criação de tarefa, opções de continuação e um agendador de tarefas personalizado.

using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   static CancellationTokenSource cts = new CancellationTokenSource();

   static TaskFactory<int> factory = new TaskFactory<int>(
      cts.Token,
      TaskCreationOptions.PreferFairness,
      TaskContinuationOptions.ExecuteSynchronously,
      new CustomScheduler());

   static void Main()
   {
      var t2 = factory.StartNew(() => DoWork());
      cts.Dispose();
   }

   static int DoWork()
   {
       /*...*/
       return DateTime.Now.Hour <= 12 ?  1 : 2;
    }
}

Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim cts As New CancellationTokenSource()
      Dim factory As New TaskFactory(Of Integer)(
                         cts.Token,
                         TaskCreationOptions.PreferFairness,
                         TaskContinuationOptions.ExecuteSynchronously,
                         New CustomScheduler())

      Dim t2 = factory.StartNew(Function() DoWork())
      cts.Dispose()
   End Sub

   Function DoWork() As Integer
      Return If(Date.Now.Hour <= 12, 1, 2)
   End Function
End Module

Na maioria dos casos, você não precisa instanciar uma nova TaskFactory<TResult> instância. Em vez disso, você pode usar a propriedade estática Task<TResult>.Factory , que retorna um objeto de fábrica que usa valores padrão. Em seguida, você pode chamar seus métodos para iniciar novas tarefas ou definir continuações de tarefa. Para obter uma ilustração, consulte o exemplo.

Construtores

TaskFactory<TResult>()	Inicializa uma instância de TaskFactory<TResult> com a configuração padrão.
TaskFactory<TResult>(CancellationToken)	Inicializa uma instância de TaskFactory<TResult> com a configuração padrão.
TaskFactory<TResult>(CancellationToken, TaskCreationOptions, TaskContinuationOptions, TaskScheduler)	Inicializa uma instância TaskFactory<TResult> com a configuração especificada.
TaskFactory<TResult>(TaskCreationOptions, TaskContinuationOptions)	Inicializa uma instância TaskFactory<TResult> com a configuração especificada.
TaskFactory<TResult>(TaskScheduler)	Inicializa uma instância TaskFactory<TResult> com a configuração especificada.

Propriedades

CancellationToken	Obtém o token de cancelamento padrão desta fábrica de tarefas.
ContinuationOptions	Obtém o valor de enumeração TaskContinuationOptions para esta fábrica de tarefas.
CreationOptions	Obtém o valor de enumeração TaskCreationOptions para esta fábrica de tarefas.
Scheduler	Obtém o agendador de tarefas para esta fábrica de tarefas.

Métodos

ContinueWhenAll(Task[], Func<Task[],TResult>)	Cria uma tarefa de continuação que será iniciada após a conclusão de um conjunto de tarefas fornecidas.
ContinueWhenAll(Task[], Func<Task[],TResult>, CancellationToken)	Cria uma tarefa de continuação que será iniciada após a conclusão de um conjunto de tarefas fornecidas.
ContinueWhenAll(Task[], Func<Task[],TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Cria uma tarefa de continuação que será iniciada após a conclusão de um conjunto de Tarefas fornecidas.
ContinueWhenAll(Task[], Func<Task[],TResult>, TaskContinuationOptions)	Cria uma tarefa de continuação que será iniciada após a conclusão de um conjunto de Tarefas fornecidas.
ContinueWhenAll<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>[],TResult>)	Cria uma tarefa de continuação que será iniciada após a conclusão de um conjunto de tarefas fornecidas.
ContinueWhenAll<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>[],TResult>, CancellationToken)	Cria uma tarefa de continuação que será iniciada após a conclusão de um conjunto de tarefas fornecidas.
ContinueWhenAll<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>[],TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Cria uma tarefa de continuação que será iniciada após a conclusão de um conjunto de tarefas fornecidas.
ContinueWhenAll<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>[],TResult>, TaskContinuationOptions)	Cria uma tarefa de continuação que será iniciada após a conclusão de um conjunto de tarefas fornecidas.
ContinueWhenAny(Task[], Func<Task,TResult>)	Cria uma tarefa de continuação que será iniciada após a conclusão de qualquer tarefa no conjunto fornecido.
ContinueWhenAny(Task[], Func<Task,TResult>, CancellationToken)	Cria uma tarefa de continuação que será iniciada após a conclusão de qualquer tarefa no conjunto fornecido.
ContinueWhenAny(Task[], Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Cria uma tarefa de continuação que será iniciada após a conclusão de qualquer tarefa no conjunto fornecido.
ContinueWhenAny(Task[], Func<Task,TResult>, TaskContinuationOptions)	Cria uma tarefa de continuação que será iniciada após a conclusão de qualquer tarefa no conjunto fornecido.
ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>,TResult>)	Cria uma tarefa de continuação que será iniciada após a conclusão de qualquer tarefa no conjunto fornecido.
ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>,TResult>, CancellationToken)	Cria uma tarefa de continuação que será iniciada após a conclusão de qualquer tarefa no conjunto fornecido.
ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Cria uma tarefa de continuação que será iniciada após a conclusão de qualquer tarefa no conjunto fornecido.
ContinueWhenAny<TAntecedentResult>(Task<TAntecedentResult>[], Func<Task<TAntecedentResult>,TResult>, TaskContinuationOptions)	Cria uma tarefa de continuação que será iniciada após a conclusão de qualquer tarefa no conjunto fornecido.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Func<IAsyncResult,TResult>, Object)	Cria uma tarefa que representa um par de métodos de início e de encerramento que estão em conformidade com o padrão do Modelo de Programação Assíncrona.
FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Func<IAsyncResult,TResult>, Object, TaskCreationOptions)	Cria uma tarefa que representa um par de métodos de início e de encerramento que estão em conformidade com o padrão do Modelo de Programação Assíncrona.
FromAsync(IAsyncResult, Func<IAsyncResult,TResult>)	Cria uma tarefa que executa uma função do método de encerramento quando um IAsyncResult especificado é concluído.
FromAsync(IAsyncResult, Func<IAsyncResult,TResult>, TaskCreationOptions)	Cria uma tarefa que executa uma função do método de encerramento quando um IAsyncResult especificado é concluído.
FromAsync(IAsyncResult, Func<IAsyncResult,TResult>, TaskCreationOptions, TaskScheduler)	Cria uma tarefa que executa uma função do método de encerramento quando um IAsyncResult especificado é concluído.
FromAsync<TArg1,TArg2,TArg3>(Func<TArg1,TArg2,TArg3,AsyncCallback,Object,IAsyncResult>, Func<IAsyncResult,TResult>, TArg1, TArg2, TArg3, Object)	Cria uma tarefa que representa um par de métodos de início e de encerramento que estão em conformidade com o padrão do Modelo de Programação Assíncrona.
FromAsync<TArg1,TArg2,TArg3>(Func<TArg1,TArg2,TArg3,AsyncCallback, Object,IAsyncResult>, Func<IAsyncResult,TResult>, TArg1, TArg2, TArg3, Object, TaskCreationOptions)	Cria uma tarefa que representa um par de métodos de início e de encerramento que estão em conformidade com o padrão do Modelo de Programação Assíncrona.
FromAsync<TArg1,TArg2>(Func<TArg1,TArg2,AsyncCallback,Object,IAsyncResult>, Func<IAsyncResult,TResult>, TArg1, TArg2, Object)	Cria uma tarefa que representa um par de métodos de início e de encerramento que estão em conformidade com o padrão do Modelo de Programação Assíncrona.
FromAsync<TArg1,TArg2>(Func<TArg1,TArg2,AsyncCallback,Object,IAsyncResult>, Func<IAsyncResult,TResult>, TArg1, TArg2, Object, TaskCreationOptions)	Cria uma tarefa que representa um par de métodos de início e de encerramento que estão em conformidade com o padrão do Modelo de Programação Assíncrona.
FromAsync<TArg1>(Func<TArg1,AsyncCallback,Object,IAsyncResult>, Func<IAsyncResult,TResult>, TArg1, Object)	Cria uma tarefa que representa um par de métodos de início e de encerramento que estão em conformidade com o padrão do Modelo de Programação Assíncrona.
FromAsync<TArg1>(Func<TArg1,AsyncCallback,Object,IAsyncResult>, Func<IAsyncResult,TResult>, TArg1, Object, TaskCreationOptions)	Cria uma tarefa que representa um par de métodos de início e de encerramento que estão em conformidade com o padrão do Modelo de Programação Assíncrona.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
StartNew(Func<Object,TResult>, Object)	Cria e inicia uma tarefa.
StartNew(Func<Object,TResult>, Object, CancellationToken)	Cria e inicia uma tarefa.
StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	Cria e inicia uma tarefa.
StartNew(Func<Object,TResult>, Object, TaskCreationOptions)	Cria e inicia uma tarefa.
StartNew(Func<TResult>)	Cria e inicia uma tarefa.
StartNew(Func<TResult>, CancellationToken)	Cria e inicia uma tarefa.
StartNew(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)	Cria e inicia uma tarefa.
StartNew(Func<TResult>, TaskCreationOptions)	Cria e inicia uma tarefa.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a

Acesso thread-safe

Todos os membros públicos e protegidos TaskFactory<TResult> são thread-safe e podem ser usados simultaneamente de vários threads.

Confira também

Biblioteca de tarefas paralelas (TPL)