Task<TResult>.Factory Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает фабричные методы для создания и настройки Task<TResult> экземпляров.
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)Значение свойства
Объект фабрики, который может создавать разнообразные объекты Task<TResult>.
Комментарии
Это свойство возвращает экземпляр класса по умолчанию, идентичный TaskFactory<TResult> созданному путем вызова конструктора без TaskFactory<TResult>.TaskFactory<TResult>() параметров. Он имеет следующие значения свойств:
Чаще всего это свойство используется для создания и запуска новой задачи в одном вызове TaskFactory<TResult>.StartNew метода.
Примечание
Начиная с платформа .NET Framework 4.5, Task.Run метод предоставляет самый простой Task<TResult> способ создания объекта со значениями конфигурации по умолчанию.
В следующем примере используется статическое Factory свойство для выполнения трех вызовов TaskFactory<TResult>.StartNew метода. Первый запускает Task<Int32> объект, который выполняет лямбда-выражение, которое возвращает 1. Второй запускает Task<Test> объект, который выполняет лямбда-выражение, которое создает экземпляр нового Test экземпляра. Третий Task<String[]> запускает объект, который перечисляет файлы в каталоге C:\Users\Public\Pictures\Sample Pictures. (Обратите внимание, что успешное выполнение примера требует наличия каталога и его хранения файлов.
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