Task<TResult>.Factory プロパティ

定義

インスタンスを作成および構成 Task<TResult> するためのファクトリ メソッドを取得します。

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)

プロパティ値

TaskFactory<TResult>

さまざまな Task<TResult> オブジェクトを作成できるファクトリ オブジェクト。

注釈

このプロパティは、パラメーターなしのTaskFactory<TResult>.TaskFactory<TResult>()コンストラクターをTaskFactory<TResult>呼び出して作成されたものと同じクラスの既定のインスタンスを返します。 これには、次のプロパティ値があります。

プロパティ [値]
TaskFactory<TResult>.CancellationToken CancellationToken.None
TaskFactory<TResult>.ContinuationOptions TaskContinuationOptions.None
TaskFactory<TResult>.CreationOptions TaskCreationOptions.None
TaskFactory<TResult>.Scheduler null または TaskScheduler.Current

このプロパティの最も一般的な用途は、メソッドの 1 回の呼び出しで新しいタスクを作成して TaskFactory<TResult>.StartNew 開始することです。

注意

.NET Framework 4.5 以降では、既定のTask.Run構成値を持つオブジェクトを作成する最も簡単なTask<TResult>方法が提供されます。

次の例では、静的 Factory プロパティを使用して、メソッドを 3 回呼び出 TaskFactory<TResult>.StartNew します。 1 つ目は、1 を返すラムダ式を実行するオブジェクトを開始 Task<Int32> します。 2 つ目は、新しいTestインスタンスをTask<Test>インスタンス化するラムダ式を実行するオブジェクトを開始します。 3 つ目は、C:\Users\Public\Pictures\Sample Pictures\ ディレクトリ内のファイルを列挙するオブジェクトを開始 Task<String[]> します。 (この例を正常に実行するには、ディレクトリが存在し、ファイルが含まれている必要があることに注意してください。

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

適用対象

こちらもご覧ください