Task<TResult>.Factory Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine Factorymethode zum Erstellen und Konfigurieren von Task<TResult> Instanzen ab.
public:
static property System::Threading::Tasks::TaskFactory<TResult> ^ Factory { System::Threading::Tasks::TaskFactory<TResult> ^ get(); };public static System.Threading.Tasks.TaskFactory<TResult> Factory { get; }static member Factory : System.Threading.Tasks.TaskFactory<'Result>Public Shared ReadOnly Property Factory As TaskFactory(Of TResult)Eigenschaftswert
Ein Factoryobjekt, das eine Vielzahl von Task<TResult>-Objekten erstellen kann.
Hinweise
Diese Eigenschaft gibt eine Standardinstanz der -Klasse zurück, die TaskFactory<TResult> mit der instanz identisch ist, die durch Aufrufen des parameterlosen TaskFactory<TResult>.TaskFactory<TResult>() Konstruktors erstellt wurde. Sie verfügt über die folgenden Eigenschaftswerte:
Die häufigste Verwendung dieser Eigenschaft besteht darin, eine neue Aufgabe in einem einzigen Aufruf der TaskFactory<TResult>.StartNew -Methode zu erstellen und zu starten.
Hinweis
Ab dem .NET Framework 4.5 bietet die Task.Run -Methode die einfachste Möglichkeit, ein Task<TResult> Objekt mit Standardkonfigurationswerten zu erstellen.
Im folgenden Beispiel wird die static-Eigenschaft Factory verwendet, um drei Aufrufe der TaskFactory<TResult>.StartNew -Methode auszuführen. Die erste startet ein Task<Int32> -Objekt, das einen Lambdaausdruck ausführt, der 1 zurückgibt. Die zweite startet ein Task<Test> -Objekt, das einen Lambdaausdruck ausführt, der eine neue Test Instanz instanziiert. Die dritte startet ein Task<String[]> -Objekt, das die Dateien im Verzeichnis C:\Users\Public\Pictures\Sample Pictures\ auflistet. (Beachten Sie, dass die erfolgreiche Ausführung des Beispiels erfordert, dass das Verzeichnis vorhanden ist und dateien enthält.
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
