Task<TResult>.Factory Egenskap

Definition

Hämtar en fabriksmetod för att skapa och konfigurera Task<TResult> instanser.

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)

Egenskapsvärde

Ett fabriksobjekt som kan skapa en mängd Task<TResult> olika objekt.

Kommentarer

Den här egenskapen returnerar en standardinstans av TaskFactory<TResult> klassen som är identisk med den som skapades genom att anropa den parameterlösa TaskFactory<TResult>.TaskFactory<TResult>() konstruktorn. Den har följande egenskapsvärden:

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

Den vanligaste användningen av den här egenskapen är att skapa och starta en ny uppgift i ett enda anrop till TaskFactory<TResult>.StartNew metoden.

Note

Från och med .NET Framework 4.5 är metoden Task.Run det enklaste sättet att skapa ett Task<TResult>-objekt med standardkonfigurationsvärden.

I följande exempel används den statiska Factory egenskapen för att göra tre anrop till TaskFactory<TResult>.StartNew metoden. Den första startar ett Task<Int32> objekt som kör ett lambda-uttryck som returnerar 1. Det andra startar ett Task<Test> objekt som kör ett lambda-uttryck som instansierar en ny Test instans. Det tredje startar ett Task<String[]> objekt som räknar upp filerna i katalogen C:\Users\Public\Pictures\Sample Pictures\. (Observera att en lyckad körning av exemplet kräver att katalogen finns och att den innehåller filer.

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

Gäller för

Se även