Task<TResult>.Factory Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene un método de fábrica para crear y configurar Task<TResult> instancias.
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 de propiedad
Un objeto de fábrica que puede crear una variedad de objetos Task<TResult>.
Comentarios
Esta propiedad devuelve una instancia predeterminada de la TaskFactory<TResult> clase que es idéntica a la creada mediante una llamada al constructor sin TaskFactory<TResult>.TaskFactory<TResult>() parámetros. Tiene los siguientes valores de propiedad:
El uso más común de esta propiedad es crear e iniciar una nueva tarea en una sola llamada al TaskFactory<TResult>.StartNew método .
Nota
A partir de .NET Framework 4.5, el Task.Run método proporciona la manera más fácil de crear un Task<TResult> objeto con valores de configuración predeterminados.
En el ejemplo siguiente se usa la propiedad estática Factory para realizar tres llamadas al TaskFactory<TResult>.StartNew método . La primera inicia un Task<Int32> objeto , que ejecuta una expresión lambda que devuelve 1. El segundo inicia un Task<Test> objeto , que ejecuta una expresión lambda que crea una instancia de una nueva Test instancia. El tercero inicia un Task<String[]> objeto , que enumera los archivos en el directorio C:\Users\Public\Pictures\Sample Pictures. (Tenga en cuenta que la ejecución correcta del ejemplo requiere que el directorio exista y que contenga archivos.
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