Task<TResult>.Factory Propriedade

public:
 static property System::Threading::Tasks::TaskFactory<TResult> ^ Factory { System::Threading::Tasks::TaskFactory<TResult> ^ get(); };

public static System.Threading.Tasks.TaskFactory<TResult> Factory { get; }

static member Factory : System.Threading.Tasks.TaskFactory<'Result>

Public Shared ReadOnly Property Factory As TaskFactory(Of TResult)

Valor de Propriedade

Um objeto de fábrica que pode criar uma variedade de Task<TResult> objetos.

Observações

Esta propriedade devolve uma instância padrão da TaskFactory<TResult> classe que é idêntica à criada ao chamar o construtor sem TaskFactory<TResult>.TaskFactory<TResult>() parâmetros. Tem os seguintes valores de propriedade:

O uso mais comum desta propriedade é criar e iniciar uma nova tarefa numa única chamada ao TaskFactory<TResult>.StartNew método.

O exemplo seguinte 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 ficheiros no diretório C:\Users\Public\Pictures\Sample Pictures\. (Note que a execução bem-sucedida do exemplo requer que o diretório exista e que contenha ficheiros.

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

Ver também

• Biblioteca paralela de tarefas (TPL)
• Programação Assíncrona Baseada em Tarefas