Task.Factory Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Ger åtkomst till fabriksmetoder för att skapa och konfigurera Task och Task<TResult> instanser.
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
Egenskapsvärde
Ett fabriksobjekt som kan skapa en mängd Task olika objekt och Task<TResult> objekt.
Kommentarer
Den här egenskapen returnerar en standardinstans av TaskFactory klassen som är identisk med den som skapades genom att anropa den parameterlösa TaskFactory.TaskFactory() konstruktorn. Den har följande egenskapsvärden:
Den vanligaste användningen av den här egenskapen är att skapa och starta en ny uppgift i ett enda anrop till TaskFactory.StartNew metoden.
Note
Från och med .NET Framework 4.5 är metoden Task.Run det enklaste sättet att skapa ett Task-objekt med standardkonfigurationsvärden.
I följande exempel används den statiska Factory egenskapen för att göra två anrop till TaskFactory.StartNew metoden. Den första fyller i en matris med namnen på filer i användarens katalog MyDocuments, medan den andra fyller i en matris med namnen på underkataloger för användarens Katalog MyDocuments. Den anropar TaskFactory.ContinueWhenAll(Task[], Action<Task[]>) sedan metoden, som visar information om antalet filer och kataloger i de två matriserna efter att de två första aktiviteterna har slutfört körningen.
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