Task.Factory Özellik

Tanım

Ad Alanı:

System.Threading.Tasks

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Kaynak:

Task.cs

Ve örnekleri oluşturmak ve yapılandırmak için fabrika yöntemlerine TaskTask<TResult> erişim sağlar.

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

Özellik Değeri

TaskFactory

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

Açıklamalar

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

Mülkiyet	Değer
TaskFactory.CancellationToken	CancellationToken.None
TaskFactory.ContinuationOptions	TaskContinuationOptions.None
TaskFactory.CreationOptions	TaskCreationOptions.None
TaskFactory.Scheduler	nullveya 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.StartNew .

Uyarı

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

Aşağıdaki örnek, yöntemine iki çağrı yapmak için TaskFactory.StartNew statik Factory özelliğini kullanır. birincisi bir diziyi kullanıcının MyDocuments dizinindeki dosyaların adlarıyla doldururken, ikincisi bir diziyi kullanıcının MyDocuments dizininin alt dizinlerinin adlarıyla doldurur. Ardından, ilk iki görev yürütme tamamlandıktan TaskFactory.ContinueWhenAll(Task[], Action<Task[]>) sonra iki dizideki dosya ve dizin sayısı hakkında bilgi görüntüleyen yöntemini çağırır.

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

Ayrıca bkz.

• TaskFactory