Task.Factory Properti

Definisi

Ruang nama:

System.Threading.Tasks

Rakitan:

netstandard.dll, System.Runtime.dll

Sumber:

Task.cs

Menyediakan akses ke metode pabrik untuk membuat dan mengonfigurasi Task dan Task<TResult> instans.

public:
 static property System::Threading::Tasks::TaskFactory ^ Factory { System::Threading::Tasks::TaskFactory ^ get(); };

public static System.Threading.Tasks.TaskFactory Factory { get; }

static member Factory : System.Threading.Tasks.TaskFactory

Public Shared ReadOnly Property Factory As TaskFactory

Nilai Properti

TaskFactory

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

Keterangan

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

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

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

Nota

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

Contoh berikut menggunakan properti statis Factory untuk melakukan dua panggilan ke TaskFactory.StartNew metode . Yang pertama mengisi array dengan nama file di direktori MyDocuments pengguna, sementara yang kedua mengisi array dengan nama subdirektori direktori MyDocuments pengguna. Kemudian memanggil TaskFactory.ContinueWhenAll(Task[], Action<Task[]>) metode , yang menampilkan informasi tentang jumlah file dan direktori dalam dua array setelah dua tugas pertama selesai dieksekusi.

using System;
using System.IO;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      Task[] tasks = new Task[2];
      String[] files = null;
      String[] dirs = null;
      String docsDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);

      tasks[0] = Task.Factory.StartNew( () => files = Directory.GetFiles(docsDirectory));
      tasks[1] = Task.Factory.StartNew( () => dirs = Directory.GetDirectories(docsDirectory));

      Task.Factory.ContinueWhenAll(tasks, completedTasks => {
                                             Console.WriteLine("{0} contains: ", docsDirectory);
                                             Console.WriteLine("   {0} subdirectories", dirs.Length);
                                             Console.WriteLine("   {0} files", files.Length);
                                          } );
   }
}
// The example displays output like the following:
//       C:\Users\<username>\Documents contains:
//          24 subdirectories
//          16 files

open System
open System.IO
open System.Threading.Tasks

let mutable files = Unchecked.defaultof<string[]>
let mutable dirs = Unchecked.defaultof<string[]>
let docsDirectory = Environment.GetFolderPath Environment.SpecialFolder.MyDocuments

let tasks =
    [| Task.Factory.StartNew(fun () -> files <- Directory.GetFiles docsDirectory)
       Task.Factory.StartNew(fun () -> dirs <- Directory.GetDirectories docsDirectory) |]

Task.Factory.ContinueWhenAll(
    tasks,
    fun completedTasks ->
        printfn $"{docsDirectory} contains: "
        printfn $"   {dirs.Length} subdirectories"
        printfn $"   {files.Length} files"
)
|> ignore

// The example displays output like the following:
//       C:\Users\<username>\Documents contains:
//          24 subdirectories
//          16 files

Imports System.IO
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim tasks(1) As Task
      Dim files() As String = Nothing
      Dim dirs() As String = Nothing
      Dim docsDirectory As String = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments)
      
      tasks(0) = Task.Factory.StartNew( Sub()
                                           files = Directory.GetFiles(docsDirectory)
                                        End Sub )
      tasks(1) = Task.Factory.StartNew( Sub()
                                           dirs = Directory.GetDirectories(docsDirectory)
                                        End Sub )
      Task.Factory.ContinueWhenAll(tasks, Sub(completedTasks)
                                             Console.WriteLine("{0} contains: ", docsDirectory)
                                             Console.WriteLine("   {0} subdirectories", dirs.Length)
                                             Console.WriteLine("   {0} files", files.Length)
                                          End Sub)
   End Sub
End Module
' The example displays output like the following:
'       C:\Users\<username>\Documents contains:
'          24 subdirectories
'          16 files

Lihat juga

• TaskFactory