Task<TResult>.Factory Vlastnost
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í.
Získá metodu továrny pro vytváření a konfiguraci Task<TResult> instancí.
public:
static property System::Threading::Tasks::TaskFactory<TResult> ^ Factory { System::Threading::Tasks::TaskFactory<TResult> ^ get(); };public static System.Threading.Tasks.TaskFactory<TResult> Factory { get; }member this.Factory : System.Threading.Tasks.TaskFactory<'Result>Public Shared ReadOnly Property Factory As TaskFactory(Of TResult)Hodnota vlastnosti
Objekt továrny, který může vytvořit celou řadu Task<TResult> objektů.
Poznámky
Tato vlastnost vrátí výchozí instanci třídy, která je identická s tou TaskFactory<TResult> vytvořenou voláním konstruktoru bez TaskFactory<TResult>.TaskFactory<TResult>() parametrů. Má následující hodnoty vlastností:
Nejběžnějším použitím této vlastnosti je vytvoření a spuštění nového úkolu v jednom volání TaskFactory<TResult>.StartNew metody.
Poznámka
Počínaje rozhraním .NET Framework 4.5 Task.Run poskytuje metoda nejjednodušší způsob, jak vytvořit Task<TResult> objekt s výchozími hodnotami konfigurace.
Následující příklad používá statickou Factory vlastnost k provedení tří volání TaskFactory<TResult>.StartNew metody. První spustí Task<Int32> objekt, který spustí výraz lambda, který vrátí hodnotu 1. Druhá spustí Task<Test> objekt, který spustí výraz lambda, který vytvoří instanci nové Test instance. Třetí spustí Task<String[]> objekt, který vytvoří výčet souborů v adresáři C:\Users\Public\Pictures\Sample Pictures. (Všimněte si, že úspěšné spuštění příkladu vyžaduje, aby adresář existoval a že obsahuje soubory.
using System;
using System.Linq;
using System.Threading.Tasks;
class Program
{
static void Main()
{
// Return a value type with a lambda expression
Task<int> task1 = Task<int>.Factory.StartNew(() => 1);
int i = task1.Result;
// Return a named reference type with a multi-line statement lambda.
Task<Test> task2 = Task<Test>.Factory.StartNew(() =>
{
string s = ".NET";
double d = 4.0;
return new Test { Name = s, Number = d };
});
Test test = task2.Result;
// Return an array produced by a PLINQ query
Task<string[]> task3 = Task<string[]>.Factory.StartNew(() =>
{
string path = @"C:\Users\Public\Pictures\Sample Pictures\";
string[] files = System.IO.Directory.GetFiles(path);
var result = (from file in files.AsParallel()
let info = new System.IO.FileInfo(file)
where info.Extension == ".jpg"
select file).ToArray();
return result;
});
foreach (var name in task3.Result)
Console.WriteLine(name);
}
class Test
{
public string Name { get; set; }
public double Number { get; set; }
}
}
Imports System.Threading.Tasks
Module Module1
Sub Main()
ReturnAValue()
Console.WriteLine("Press any key to exit.")
Console.ReadKey()
End Sub
Sub ReturnAValue()
' Return a value type with a lambda expression
Dim task1 = Task(Of Integer).Factory.StartNew(Function() 1)
Dim i As Integer = task1.Result
' Return a named reference type with a multi-line statement lambda.
Dim task2 As Task(Of Test) = Task.Factory.StartNew(Function()
Dim s As String = ".NET"
Dim d As Integer = 4
Return New Test With {.Name = s, .Number = d}
End Function)
Dim myTest As Test = task2.Result
Console.WriteLine(myTest.Name & ": " & myTest.Number)
' Return an array produced by a PLINQ query.
Dim task3 As Task(Of String())= Task(Of String()).Factory.StartNew(Function()
Dim path = "C:\Users\Public\Pictures\Sample Pictures\"
Dim files = System.IO.Directory.GetFiles(path)
Dim result = (From file In files.AsParallel()
Let info = New System.IO.FileInfo(file)
Where info.Extension = ".jpg"
Select file).ToArray()
Return result
End Function)
For Each name As String In task3.Result
Console.WriteLine(name)
Next
End Sub
Class Test
Public Name As String
Public Number As Double
End Class
End Module