Task<TResult>.Factory Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient une méthode de fabrique pour créer et configurer des Task<TResult> instances.
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)Valeur de propriété
Objet de fabrique pouvant créer une variété d'objets Task<TResult>.
Remarques
Cette propriété retourne une instance par défaut de la TaskFactory<TResult> classe identique à celle créée en appelant le constructeur sans TaskFactory<TResult>.TaskFactory<TResult>() paramètre. Il a les valeurs de propriété suivantes :
L’utilisation la plus courante de cette propriété consiste à créer et à démarrer une tâche dans un seul appel à la TaskFactory<TResult>.StartNew méthode.
Notes
À compter du .NET Framework 4.5, la Task.Run méthode fournit le moyen le plus simple de créer un Task<TResult> objet avec des valeurs de configuration par défaut.
L’exemple suivant utilise la propriété statique Factory pour effectuer trois appels à la TaskFactory<TResult>.StartNew méthode. Le premier démarre un Task<Int32> objet, qui exécute une expression lambda qui retourne 1. La seconde démarre un Task<Test> objet, qui exécute une expression lambda qui instancie une nouvelle Test instance. Le troisième démarre un Task<String[]> objet, qui énumère les fichiers du répertoire C:\Users\Public\Pictures\Sample Pictures. (Notez que l’exécution réussie de l’exemple nécessite que le répertoire existe et qu’il contienne des fichiers.
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