Task<TResult>.Factory Özellik

Tanım

Örnekleri oluşturmak ve yapılandırmak Task<TResult> için bir fabrika yöntemi alır.

public:
 static property System::Threading::Tasks::TaskFactory<TResult> ^ Factory { System::Threading::Tasks::TaskFactory<TResult> ^ get(); };
public static System.Threading.Tasks.TaskFactory<TResult> Factory { get; }
member this.Factory : System.Threading.Tasks.TaskFactory<'Result>
Public Shared ReadOnly Property Factory As TaskFactory(Of TResult)

Özellik Değeri

TaskFactory<TResult>

Çeşitli Task<TResult> nesneler oluşturabilen bir fabrika nesnesi.

Açıklamalar

Bu özellik, parametresiz TaskFactory<TResult>.TaskFactory<TResult>() oluşturucu çağrılarak oluşturulanla aynı olan sınıfın varsayılan örneğini TaskFactory<TResult> döndürür. Aşağıdaki özellik değerlerine sahiptir:

Özellik Değer
TaskFactory<TResult>.CancellationToken CancellationToken.None
TaskFactory<TResult>.ContinuationOptions TaskContinuationOptions.None
TaskFactory<TResult>.CreationOptions TaskCreationOptions.None
TaskFactory<TResult>.Scheduler null veya TaskScheduler.Current

Bu özelliğin en yaygın kullanımı, yöntemine yapılan tek bir çağrıda yeni bir görev oluşturmak ve başlatmaktır TaskFactory<TResult>.StartNew .

Not

yöntemi, Task.Run .NET Framework 4.5'den başlayarak varsayılan yapılandırma değerlerine sahip bir Task<TResult> nesne oluşturmanın en kolay yolunu sağlar.

Aşağıdaki örnek, yöntemine üç çağrı yapmak için TaskFactory<TResult>.StartNew statik Factory özelliğini kullanır. İlki, 1 döndüren bir lambda ifadesi yürüten bir nesnesi başlatır Task<Int32> . İkincisi, yeni Test bir Task<Test> örneğin örneğini oluşturan bir lambda ifadesi yürüten bir nesnesi başlatır. Üçüncüsü, C:\Users\Public\Pictures\Sample Pictures\ dizinindeki dosyaları numaralandıran bir Task<String[]> nesne başlatır. (Örneğin başarılı bir şekilde yürütülmesi için dizinin mevcut olması ve dosya içermesi gerektiğini unutmayın.

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

Şunlara uygulanır

Ayrıca bkz.