Task<TResult>.Factory Eigenschap

Definitie

Hiermee haalt u een factorymethode op voor het maken en configureren van Task<TResult> exemplaren.

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)

Waarde van eigenschap

Een factory-object dat een verscheidenheid aan Task<TResult> objecten kan maken.

Opmerkingen

Deze eigenschap retourneert een standaardexemplaren van de TaskFactory<TResult> klasse die identiek is aan de klasse die is gemaakt door de parameterloze TaskFactory<TResult>.TaskFactory<TResult>() constructor aan te roepen. De eigenschap heeft de volgende eigenschapswaarden:

Property Value
TaskFactory<TResult>.CancellationToken CancellationToken.None
TaskFactory<TResult>.ContinuationOptions TaskContinuationOptions.None
TaskFactory<TResult>.CreationOptions TaskCreationOptions.None
TaskFactory<TResult>.Scheduler null, of TaskScheduler.Current

Het meest voorkomende gebruik van deze eigenschap is het maken en starten van een nieuwe taak in één aanroep naar de TaskFactory<TResult>.StartNew methode.

Note

Vanaf .NET Framework 4.5 biedt de methode Task.Run de eenvoudigste manier om een Task<TResult>-object met standaardconfiguratiewaarden te maken.

In het volgende voorbeeld wordt de statische Factory eigenschap gebruikt om drie aanroepen naar de TaskFactory<TResult>.StartNew methode uit te voeren. De eerste start een Task<Int32> object, waarmee een lambda-expressie wordt uitgevoerd die 1 retourneert. Met de tweede wordt een Task<Test> object gestart, waarmee een lambda-expressie wordt uitgevoerd waarmee een nieuw Test exemplaar wordt geïnstitueerd. De derde start een Task<String[]> object, waarmee de bestanden in de map C:\Users\Public\Pictures\Sample Pictures\ worden opgesomd. (Houd er rekening mee dat een geslaagde uitvoering van het voorbeeld vereist dat de map bestaat en dat deze bestanden bevat.

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

Van toepassing op

Zie ook