TaskFactory Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje podporu pro vytváření a plánování Task objektů.
public ref class TaskFactorypublic class TaskFactorytype TaskFactory = classPublic Class TaskFactory- Dědičnost
-
TaskFactory
Příklady
Následující příklad používá statickou Factory vlastnost k provedení dvou volání TaskFactory.StartNew metody. První naplní pole názvy souborů v adresáři MyDocuments uživatele, zatímco druhý naplní pole názvy podadresářů adresáře MyDocuments uživatele. Potom volá metodu TaskFactory.ContinueWhenAll(Task[], Action<Task[]>) , která zobrazuje informace o počtu souborů a adresářů ve dvou polích po dokončení prvního provedení dvou úkolů.
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
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
Poznámky
.NET poskytuje dvě továrny pro vytváření a plánování úkolů:
Třída TaskFactory , která vytváří Task a Task<TResult> objekty. Přetížení této metody můžete volat k vytvoření a spuštění úlohy, která vyžaduje jiné než výchozí argumenty.
Upozornění
Počínaje .NET Framework 4.5 Task.Run poskytuje metoda nejjednodušší způsob, jak vytvořit úlohu s výchozími hodnotami konfigurace a okamžitě ji spustit.
Třída TaskFactory<TResult> , která vytváří Task<TResult> objekty.
Třída TaskFactory umožňuje provádět následující akce:
Vytvořte úkol a spusťte ho StartNew okamžitě voláním metody.
Upozornění
Počínaje .NET Framework 4.5 Task.Run poskytuje metoda nejjednodušší způsob, jak vytvořit úlohu s výchozími hodnotami konfigurace a okamžitě ji spustit.
Vytvořte úlohu, která začíná, když některý z úkolů v poli dokončil voláním ContinueWhenAny metody.
Vytvořte úlohu, která začíná, když jsou všechny úkoly v poli dokončeny voláním ContinueWhenAll metody.
Statická Task<TResult>.Factory vlastnost vrátí výchozí TaskFactory<TResult> objekt. Můžete také volat jeden z TaskFactory konstruktorů třídy ke konfiguraci Task objektů, které TaskFactory třída vytvoří. Následující příklad nakonfiguruje nový TaskFactory objekt pro vytvoření úkolů, které mají zadaný token zrušení, možnosti vytvoření úkolu, možnosti pokračování a přizpůsobený plánovač úkolů.
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
class Example
{
static CancellationTokenSource cts = new CancellationTokenSource();
static TaskFactory factory = new TaskFactory(
cts.Token,
TaskCreationOptions.PreferFairness,
TaskContinuationOptions.ExecuteSynchronously,
new CustomScheduler());
static void Main()
{
var t2 = factory.StartNew(() => DoWork());
cts.Dispose();
}
static void DoWork() {/*...*/ }
}
Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks
Module Example
Public Sub Main()
Dim cts As New CancellationTokenSource()
Dim factory As New TaskFactory(cts.Token,
TaskCreationOptions.PreferFairness,
TaskContinuationOptions.ExecuteSynchronously,
New CustomScheduler())
Dim t2 = factory.StartNew(Sub() DoWork())
cts.Dispose()
End Sub
Sub DoWork()
' ...
End Sub
End Module
Ve většině případů nemusíte vytvořit instanci nové TaskFactory instance. Místo toho můžete použít Task.Factory vlastnost, která vrátí objekt továrny, který používá výchozí hodnoty. Pak můžete volat jeho metody pro zahájení nových úkolů nebo definovat pokračování úkolů. Obrázek najdete v příkladu.
Konstruktory
| TaskFactory() |
Inicializuje TaskFactory instanci s výchozí konfigurací. |
| TaskFactory(CancellationToken) |
Inicializuje TaskFactory instanci se zadanou konfigurací. |
| TaskFactory(CancellationToken, TaskCreationOptions, TaskContinuationOptions, TaskScheduler) |
Inicializuje TaskFactory instanci se zadanou konfigurací. |
| TaskFactory(TaskCreationOptions, TaskContinuationOptions) |
Inicializuje TaskFactory instanci se zadanou konfigurací. |
| TaskFactory(TaskScheduler) |
Inicializuje TaskFactory instanci se zadanou konfigurací. |
Vlastnosti
| CancellationToken |
Získá výchozí token zrušení pro tuto továrnu úloh. |
| ContinuationOptions |
Získá výchozí možnosti pokračování úkolu pro tuto továrnu úkolů. |
| CreationOptions |
Získá výchozí možnosti vytváření úkolů pro tuto továrnu úkolů. |
| Scheduler |
Získá výchozí plánovač úloh pro tuto továrnu úloh. |
Metody
Platí pro
Bezpečný přístup z více vláken
Všechny veřejné a chráněné členy TaskFactory jsou bezpečné pro vlákno a mohou být používány souběžně z více vláken.