Task<TResult>.Factory Properti

Definisi

Ruang nama:

System.Threading.Tasks

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

Future.cs

Mendapatkan metode pabrik untuk membuat dan mengonfigurasi Task<TResult> instans.

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)

Nilai Properti

TaskFactory<TResult>

Objek pabrik yang dapat membuat berbagai Task<TResult> objek.

Keterangan

Properti ini mengembalikan instans TaskFactory<TResult> default kelas yang identik dengan yang dibuat dengan memanggil konstruktor tanpa TaskFactory<TResult>.TaskFactory<TResult>() parameter. Ini memiliki nilai properti berikut:

Harta benda	Nilai
TaskFactory<TResult>.CancellationToken	CancellationToken.None
TaskFactory<TResult>.ContinuationOptions	TaskContinuationOptions.None
TaskFactory<TResult>.CreationOptions	TaskCreationOptions.None
TaskFactory<TResult>.Scheduler	null, atau TaskScheduler.Current

Penggunaan paling umum dari properti ini adalah membuat dan memulai tugas baru dalam satu panggilan ke TaskFactory<TResult>.StartNew metode .

Nota

Dimulai dengan .NET Framework 4.5, Task.Run metode ini menyediakan cara term mudah untuk membuat Task<TResult> objek dengan nilai konfigurasi default.

Contoh berikut menggunakan properti statis Factory untuk melakukan tiga panggilan ke TaskFactory<TResult>.StartNew metode . Yang pertama memulai Task<Int32> objek, yang menjalankan ekspresi lambda yang mengembalikan 1. Yang kedua memulai Task<Test> objek, yang menjalankan ekspresi lambda yang membuat instans baru Test . Yang ketiga memulai Task<String[]> objek, yang menghitung file dalam direktori C:\Users\Public\Pictures\Sample Pictures\. (Perhatikan bahwa keberhasilan eksekusi contoh mengharuskan direktori ada dan berisi file.

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

Lihat juga

• Pustaka Paralelisasi Tugas (TPL)
• Pemrograman Asinkron Berbasis Tugas