Task<TResult>.Factory Propriedade
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.
Obtém um método de fábrica para criar e configurar Task<TResult> instâncias.
public:
static property System::Threading::Tasks::TaskFactory<TResult> ^ Factory { System::Threading::Tasks::TaskFactory<TResult> ^ get(); };public static System.Threading.Tasks.TaskFactory<TResult> Factory { get; }member this.Factory : System.Threading.Tasks.TaskFactory<'Result>Public Shared ReadOnly Property Factory As TaskFactory(Of TResult)Valor da propriedade
Um objeto de fábrica que pode criar uma variedade de objetos Task<TResult>.
Comentários
Essa propriedade retorna uma instância padrão da TaskFactory<TResult> classe que é idêntica à criada chamando o construtor sem TaskFactory<TResult>.TaskFactory<TResult>() parâmetros. Ele tem os seguintes valores de propriedade:
O uso mais comum dessa propriedade é criar e iniciar uma nova tarefa em uma única chamada ao TaskFactory<TResult>.StartNew método.
Observação
Começando com o .NET Framework 4.5, o Task.Run método fornece a maneira mais fácil de criar um Task<TResult> objeto com valores de configuração padrão.
O exemplo a seguir usa a propriedade estática Factory para fazer três chamadas ao TaskFactory<TResult>.StartNew método. O primeiro inicia um Task<Int32> objeto, que executa uma expressão lambda que retorna 1. O segundo inicia um Task<Test> objeto, que executa uma expressão lambda que instancia uma nova Test instância. O terceiro inicia um Task<String[]> objeto, que enumera os arquivos no diretório C:\Users\Public\Pictures\Sample Pictures. (Observe que a execução bem-sucedida do exemplo requer que o diretório exista e que ele contenha arquivos.
using System;
using System.Linq;
using System.Threading.Tasks;
class Program
{
static void Main()
{
// Return a value type with a lambda expression
Task<int> task1 = Task<int>.Factory.StartNew(() => 1);
int i = task1.Result;
// Return a named reference type with a multi-line statement lambda.
Task<Test> task2 = Task<Test>.Factory.StartNew(() =>
{
string s = ".NET";
double d = 4.0;
return new Test { Name = s, Number = d };
});
Test test = task2.Result;
// Return an array produced by a PLINQ query
Task<string[]> task3 = Task<string[]>.Factory.StartNew(() =>
{
string path = @"C:\Users\Public\Pictures\Sample Pictures\";
string[] files = System.IO.Directory.GetFiles(path);
var result = (from file in files.AsParallel()
let info = new System.IO.FileInfo(file)
where info.Extension == ".jpg"
select file).ToArray();
return result;
});
foreach (var name in task3.Result)
Console.WriteLine(name);
}
class Test
{
public string Name { get; set; }
public double Number { get; set; }
}
}
Imports System.Threading.Tasks
Module Module1
Sub Main()
ReturnAValue()
Console.WriteLine("Press any key to exit.")
Console.ReadKey()
End Sub
Sub ReturnAValue()
' Return a value type with a lambda expression
Dim task1 = Task(Of Integer).Factory.StartNew(Function() 1)
Dim i As Integer = task1.Result
' Return a named reference type with a multi-line statement lambda.
Dim task2 As Task(Of Test) = Task.Factory.StartNew(Function()
Dim s As String = ".NET"
Dim d As Integer = 4
Return New Test With {.Name = s, .Number = d}
End Function)
Dim myTest As Test = task2.Result
Console.WriteLine(myTest.Name & ": " & myTest.Number)
' Return an array produced by a PLINQ query.
Dim task3 As Task(Of String())= Task(Of String()).Factory.StartNew(Function()
Dim path = "C:\Users\Public\Pictures\Sample Pictures\"
Dim files = System.IO.Directory.GetFiles(path)
Dim result = (From file In files.AsParallel()
Let info = New System.IO.FileInfo(file)
Where info.Extension = ".jpg"
Select file).ToArray()
Return result
End Function)
For Each name As String In task3.Result
Console.WriteLine(name)
Next
End Sub
Class Test
Public Name As String
Public Number As Double
End Class
End Module