Teilen über


Task<TResult>.Factory Eigenschaft

Definition

Ruft eine Factorymethode zum Erstellen und Konfigurieren von Task<TResult> Instanzen ab.

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)

Eigenschaftswert

Ein Factoryobjekt, das eine Vielzahl von Task<TResult>-Objekten erstellen kann.

Hinweise

Diese Eigenschaft gibt eine Standardinstanz der -Klasse zurück, die TaskFactory<TResult> mit der instanz identisch ist, die durch Aufrufen des parameterlosen TaskFactory<TResult>.TaskFactory<TResult>() Konstruktors erstellt wurde. Sie verfügt über die folgenden Eigenschaftswerte:

Eigenschaft Wert
TaskFactory<TResult>.CancellationToken CancellationToken.None
TaskFactory<TResult>.ContinuationOptions TaskContinuationOptions.None
TaskFactory<TResult>.CreationOptions TaskCreationOptions.None
TaskFactory<TResult>.Scheduler null oder TaskScheduler.Current

Die häufigste Verwendung dieser Eigenschaft besteht darin, eine neue Aufgabe in einem einzigen Aufruf der TaskFactory<TResult>.StartNew -Methode zu erstellen und zu starten.

Hinweis

Ab dem .NET Framework 4.5 bietet die Task.Run -Methode die einfachste Möglichkeit, ein Task<TResult> Objekt mit Standardkonfigurationswerten zu erstellen.

Im folgenden Beispiel wird die static-Eigenschaft Factory verwendet, um drei Aufrufe der TaskFactory<TResult>.StartNew -Methode auszuführen. Die erste startet ein Task<Int32> -Objekt, das einen Lambdaausdruck ausführt, der 1 zurückgibt. Die zweite startet ein Task<Test> -Objekt, das einen Lambdaausdruck ausführt, der eine neue Test Instanz instanziiert. Die dritte startet ein Task<String[]> -Objekt, das die Dateien im Verzeichnis C:\Users\Public\Pictures\Sample Pictures\ auflistet. (Beachten Sie, dass die erfolgreiche Ausführung des Beispiels erfordert, dass das Verzeichnis vorhanden ist und dateien enthält.

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

Gilt für:

Weitere Informationen