Task.Factory Eigenschap

Definitie

Biedt toegang tot factory-methoden voor het maken en configureren en configureren Task van Task<TResult> exemplaren.

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

Waarde van eigenschap

Een fabrieksobject dat een verscheidenheid aan Task objecten Task<TResult> kan maken.

Opmerkingen

Deze eigenschap retourneert een standaardexemplaren van de TaskFactory klasse die identiek is aan de klasse die is gemaakt door de parameterloze TaskFactory.TaskFactory() constructor aan te roepen. De eigenschap heeft de volgende eigenschapswaarden:

Property Value
TaskFactory.CancellationToken CancellationToken.None
TaskFactory.ContinuationOptions TaskContinuationOptions.None
TaskFactory.CreationOptions TaskCreationOptions.None
TaskFactory.Scheduler null, of TaskScheduler.Current

Het meest voorkomende gebruik van deze eigenschap is het maken en starten van een nieuwe taak in één aanroep naar de TaskFactory.StartNew methode.

Note

Vanaf .NET Framework 4.5 biedt de methode Task.Run de eenvoudigste manier om een Task-object met standaardconfiguratiewaarden te maken.

In het volgende voorbeeld wordt de statische Factory eigenschap gebruikt om twee aanroepen naar de TaskFactory.StartNew methode uit te voeren. De eerste vult een matrix met de namen van bestanden in de map MyDocuments van de gebruiker, terwijl de tweede een matrix vult met de namen van submappen van de map MyDocuments van de gebruiker. Vervolgens wordt de TaskFactory.ContinueWhenAll(Task[], Action<Task[]>) methode aangeroepen, die informatie weergeeft over het aantal bestanden en mappen in de twee matrices nadat de eerste twee taken de uitvoering hebben voltooid.

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

Van toepassing op

Zie ook