Task<TResult> Task<TResult> Task<TResult> Task<TResult> Constructors

Определение

Перегрузки

Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>)

Инициализирует новую задачу Task<TResult> с указанной функцией.Initializes a new Task<TResult> with the specified function.

Task<TResult>(Func<Object,TResult>, Object) Task<TResult>(Func<Object,TResult>, Object) Task<TResult>(Func<Object,TResult>, Object) Task<TResult>(Func<Object,TResult>, Object)

Инициализирует новую задачу Task<TResult> с указанными функцией и состоянием.Initializes a new Task<TResult> with the specified function and state.

Task<TResult>(Func<TResult>, CancellationToken) Task<TResult>(Func<TResult>, CancellationToken) Task<TResult>(Func<TResult>, CancellationToken)

Инициализирует новую задачу Task<TResult> с указанной функцией.Initializes a new Task<TResult> with the specified function.

Task<TResult>(Func<TResult>, TaskCreationOptions) Task<TResult>(Func<TResult>, TaskCreationOptions) Task<TResult>(Func<TResult>, TaskCreationOptions) Task<TResult>(Func<TResult>, TaskCreationOptions)

Инициализирует новую задачу Task<TResult> с указанной функцией и параметрами создания.Initializes a new Task<TResult> with the specified function and creation options.

Task<TResult>(Func<Object,TResult>, Object, CancellationToken) Task<TResult>(Func<Object,TResult>, Object, CancellationToken) Task<TResult>(Func<Object,TResult>, Object, CancellationToken)

Инициализирует новую задачу Task<TResult> с заданными действием, состоянием и параметрами.Initializes a new Task<TResult> with the specified action, state, and options.

Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions)

Инициализирует новую задачу Task<TResult> с заданными действием, состоянием и параметрами.Initializes a new Task<TResult> with the specified action, state, and options.

Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions)

Инициализирует новую задачу Task<TResult> с указанной функцией и параметрами создания.Initializes a new Task<TResult> with the specified function and creation options.

Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions)

Инициализирует новую задачу Task<TResult> с заданными действием, состоянием и параметрами.Initializes a new Task<TResult> with the specified action, state, and options.

Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>)

Инициализирует новую задачу Task<TResult> с указанной функцией.Initializes a new Task<TResult> with the specified function.

public:
 Task(Func<TResult> ^ function);
public Task (Func<TResult> function);
new System.Threading.Tasks.Task<'Result> : Func<'Result> -> System.Threading.Tasks.Task<'Result>
Public Sub New (function As Func(Of TResult))

Параметры

function
Func<TResult> Func<TResult> Func<TResult> Func<TResult>

Делегат, который представляет код, выполняемый в рамках задачи.The delegate that represents the code to execute in the task. После завершения выполнения функции для свойства задачи Result будет задано значение, равное значению, возвращенному функцией.When the function has completed, the task's Result property will be set to return the result value of the function.

Исключения

Аргумент function имеет значение null.The function argument is null.

Аргумент function имеет значение null.The function argument is null.

Примеры

В следующем примере подсчитывается приблизительное количество слов в текстовых файлах, представляющих опубликованные книги.The following example counts the approximate number of words in text files that represent published books. Каждая задача отвечает за открытие файла, чтение всего его содержимого асинхронно и вычисление числа слов с помощью регулярного выражения.Each task is responsible for opening a file, reading its entire contents asynchronously, and calculating the word count by using a regular expression. Task.WaitAll(Task[]) Метод вызывается, чтобы убедиться, что все задачи завершены, прежде чем отображать количество слов в каждой книге в консоли.The Task.WaitAll(Task[]) method is called to ensure that all tasks have completed before displaying the word count of each book to the console.

Создание экземпляра объекта отделено от выполнения объекта в этом примере, чтобы в примере можно было убедиться, что каждый файл существует.Object instantiation is separated from object execution in this example so that the example can ensure that each file exists. В противном случае отображается имя отсутствующего файла.If they do not, it displays the name of the missing file. В противном случае вызывается Task.Start метод для запуска каждой задачи.Otherwise, it calls the Task.Start method to launch each task.

using System;
using System.IO;
using System.Text.RegularExpressions;
using System.Threading.Tasks;

public class Example
{
   public static async Task Main()
   {
      string pattern = @"\p{P}*\s+";
      string[] titles = { "Sister Carrie", "The Financier" };
      Task<int>[] tasks = new Task<int>[titles.Length];

      for (int ctr = 0; ctr < titles.Length; ctr++) {
         string s = titles[ctr];
         tasks[ctr] = new Task<int>( () => {
                                   // Number of words.
                                   int nWords = 0;
                                   // Create filename from title.
                                   string fn = s + ".txt";

                                   StreamReader sr = new StreamReader(fn);
                                   string input = sr.ReadToEndAsync().Result;
                                   sr.Close();
                                   nWords = Regex.Matches(input, pattern).Count;
                                   return nWords;
                                } );
      }
      // Ensure files exist before launching tasks.
      bool allExist = true;
      foreach (var title in titles) {
         string fn = title + ".txt";
         if (! File.Exists(fn)) {
            allExist = false;
            Console.WriteLine("Cannot find '{0}'", fn);
            break;
         }   
      }
      // Launch tasks 
      if (allExist) {
         foreach (var t in tasks)
            t.Start();
      
        await Task.WhenAll(tasks);
  
        Console.WriteLine("Word Counts:\n");
        for (int ctr = 0; ctr < titles.Length; ctr++)
           Console.WriteLine("{0}: {1,10:N0} words", titles[ctr], tasks[ctr].Result);
      }   
   }
}
// The example displays the following output:
//       Sister Carrie:    159,374 words
//       The Financier:    196,362 words
Imports System.IO
Imports System.Text.RegularExpressions
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim pattern As String = "\p{P}*\s+"
      Dim titles() As String = { "Sister Carrie",
                                 "The Financier" }
      Dim tasks(titles.Length - 1) As Task(Of Integer)

      For ctr As Integer = 0 To titles.Length - 1
         Dim s As String = titles(ctr)
         tasks(ctr) = New Task(Of Integer)( Function()
                                   ' Number of words.
                                   Dim nWords As Integer = 0
                                   ' Create filename from title.
                                   Dim fn As String = s + ".txt"

                                   Dim sr As New StreamReader(fn)
                                   Dim input As String = sr.ReadToEndAsync().Result
                                   sr.Close()
                                   nWords = Regex.Matches(input, pattern).Count
                                   Return nWords
                                End Function)
      Next

      ' Ensure files exist before launching tasks.
      Dim allExist As Boolean = True
      For Each title In titles
         Dim fn As String = title + ".txt"
         If Not File.Exists(fn) Then
            allExist = false
            Console.WriteLine("Cannot find '{0}'", fn)
            Exit For
         End If   
      Next
      ' Launch tasks 
      If allExist Then
         For Each t in tasks
            t.Start()
         Next
         Task.WaitAll(tasks)

         Console.WriteLine("Word Counts:")
         Console.WriteLine()
         For ctr As Integer = 0 To titles.Length - 1
         Console.WriteLine("{0}: {1,10:N0} words", titles(ctr), tasks(ctr).Result)
         Next
      End If   
   End Sub
End Module
' The example displays the following output:
'       Sister Carrie:    159,374 words
'       The Financier:    196,362 words

Шаблон \p{P}*\s+ регулярного выражения сопоставляет ноль, один или несколько символов пунктуации, за которыми следует один или несколько пробелов.The regular expression pattern \p{P}*\s+ matches zero, one, or more punctuation characters followed by one or more white-space characters. Предполагается, что общее число совпадений равно приблизительному числу слов.It assumes that the total number of matches equals the approximate word count.

Комментарии

Этот конструктор следует использовать только в сложных сценариях, где требуется, чтобы создание и запуск задачи были разделены.This constructor should only be used in advanced scenarios where it is required that the creation and starting of the task is separated.

Вместо вызова этого конструктора наиболее распространенным способом создания экземпляра Task<TResult> объекта и запуска задачи является вызов статических Task.Run<TResult>(Func<TResult>) методов и TaskFactory<TResult>.StartNew(Func<TResult>) .Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static Task.Run<TResult>(Func<TResult>) and TaskFactory<TResult>.StartNew(Func<TResult>) methods.

Если задача, не имеющая действий, требуется для того, чтобы потребитель API имел что-либо для ожидания, TaskCompletionSource<TResult> следует использовать.If a task with no action is needed just for the consumer of an API to have something to await, a TaskCompletionSource<TResult> should be used.

Дополнительно

Task<TResult>(Func<Object,TResult>, Object) Task<TResult>(Func<Object,TResult>, Object) Task<TResult>(Func<Object,TResult>, Object) Task<TResult>(Func<Object,TResult>, Object)

Инициализирует новую задачу Task<TResult> с указанными функцией и состоянием.Initializes a new Task<TResult> with the specified function and state.

public:
 Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state);
public Task (Func<object,TResult> function, object state);
new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj -> System.Threading.Tasks.Task<'Result>
Public Sub New (function As Func(Of Object, TResult), state As Object)

Параметры

function
Func<Object,TResult>

Делегат, который представляет код, выполняемый в рамках задачи.The delegate that represents the code to execute in the task. После завершения выполнения функции для свойства задачи Result будет задано значение, равное значению, возвращенному функцией.When the function has completed, the task's Result property will be set to return the result value of the function.

state
Object Object Object Object

Объект, который представляет данные, используемые действием.An object representing data to be used by the action.

Исключения

Аргумент function имеет значение null.The function argument is null.

Аргумент function имеет значение null.The function argument is null.

Комментарии

Вместо вызова этого конструктора наиболее распространенным способом создания экземпляра Task<TResult> объекта и запуска задачи является вызов статического TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object) метода.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object) method. Единственным преимуществом, предоставляемым этим конструктором, является возможность разделения создания экземпляров объектов от вызова задач.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Дополнительно

Task<TResult>(Func<TResult>, CancellationToken) Task<TResult>(Func<TResult>, CancellationToken) Task<TResult>(Func<TResult>, CancellationToken)

Инициализирует новую задачу Task<TResult> с указанной функцией.Initializes a new Task<TResult> with the specified function.

public:
 Task(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken);
public Task (Func<TResult> function, System.Threading.CancellationToken cancellationToken);
new System.Threading.Tasks.Task<'Result> : Func<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Параметры

function
Func<TResult> Func<TResult> Func<TResult> Func<TResult>

Делегат, который представляет код, выполняемый в рамках задачи.The delegate that represents the code to execute in the task. После завершения выполнения функции для свойства задачи Result будет задано значение, равное значению, возвращенному функцией.When the function has completed, the task's Result property will be set to return the result value of the function.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Токен CancellationToken для назначения данной задаче.The CancellationToken to be assigned to this task.

Исключения

Класс CancellationTokenSource, создавший cancellationToken, уже удален.The CancellationTokenSource that created cancellationToken has already been disposed.

Аргумент function имеет значение null.The function argument is null.

Аргумент function имеет значение null.The function argument is null.

Комментарии

Вместо вызова этого конструктора наиболее распространенным способом создания экземпляра Task<TResult> объекта и запуска задачи является вызов статических Task.Run<TResult>(Func<TResult>, CancellationToken) методов и TaskFactory<TResult>.StartNew(Func<TResult>, CancellationToken) .Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static Task.Run<TResult>(Func<TResult>, CancellationToken) and TaskFactory<TResult>.StartNew(Func<TResult>, CancellationToken) methods. Единственным преимуществом, предоставляемым этим конструктором, является возможность разделения создания экземпляров объектов от вызова задач.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Дополнительно

Task<TResult>(Func<TResult>, TaskCreationOptions) Task<TResult>(Func<TResult>, TaskCreationOptions) Task<TResult>(Func<TResult>, TaskCreationOptions) Task<TResult>(Func<TResult>, TaskCreationOptions)

Инициализирует новую задачу Task<TResult> с указанной функцией и параметрами создания.Initializes a new Task<TResult> with the specified function and creation options.

public:
 Task(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);
public Task (Func<TResult> function, System.Threading.Tasks.TaskCreationOptions creationOptions);
new System.Threading.Tasks.Task<'Result> : Func<'Result> * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>
Public Sub New (function As Func(Of TResult), creationOptions As TaskCreationOptions)

Параметры

function
Func<TResult> Func<TResult> Func<TResult> Func<TResult>

Делегат, который представляет код, выполняемый в рамках задачи.The delegate that represents the code to execute in the task. После завершения выполнения функции для свойства задачи Result будет задано значение, равное значению, возвращенному функцией.When the function has completed, the task's Result property will be set to return the result value of the function.

creationOptions
TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions

Объект TaskCreationOptions, который используется для настройки поведения задачи.The TaskCreationOptions used to customize the task's behavior.

Исключения

Аргумент creationOptions задает недопустимое значение для TaskCreationOptions.The creationOptions argument specifies an invalid value for TaskCreationOptions.

Аргумент function имеет значение null.The function argument is null.

Аргумент function имеет значение null.The function argument is null.

Комментарии

Вместо вызова этого конструктора наиболее распространенным способом создания экземпляра Task<TResult> объекта и запуска задачи является вызов статического TaskFactory<TResult>.StartNew(Func<TResult>, TaskCreationOptions) метода.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<TResult>, TaskCreationOptions) method. Единственным преимуществом, предоставляемым этим конструктором, является возможность разделения создания экземпляров объектов от вызова задач.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Дополнительно

Task<TResult>(Func<Object,TResult>, Object, CancellationToken) Task<TResult>(Func<Object,TResult>, Object, CancellationToken) Task<TResult>(Func<Object,TResult>, Object, CancellationToken)

Инициализирует новую задачу Task<TResult> с заданными действием, состоянием и параметрами.Initializes a new Task<TResult> with the specified action, state, and options.

public:
 Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken);
public Task (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken);
new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Параметры

function
Func<Object,TResult>

Делегат, который представляет код, выполняемый в рамках задачи.The delegate that represents the code to execute in the task. После завершения выполнения функции для свойства задачи Result будет задано значение, равное значению, возвращенному функцией.When the function has completed, the task's Result property will be set to return the result value of the function.

state
Object Object Object Object

Объект, который представляет данные, используемые функцией.An object representing data to be used by the function.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Токен CancellationToken для назначения новой задаче.The CancellationToken to be assigned to the new task.

Исключения

Класс CancellationTokenSource, создавший cancellationToken, уже удален.The CancellationTokenSource that created cancellationToken has already been disposed.

Аргумент function имеет значение null.The function argument is null.

Аргумент function имеет значение null.The function argument is null.

Комментарии

Вместо вызова этого конструктора наиболее распространенным способом создания экземпляра Task<TResult> объекта и запуска задачи является вызов статического TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken) метода.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken) method. Единственным преимуществом, предоставляемым этим конструктором, является возможность разделения создания экземпляров объектов от вызова задач.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Дополнительно

Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions)

Инициализирует новую задачу Task<TResult> с заданными действием, состоянием и параметрами.Initializes a new Task<TResult> with the specified action, state, and options.

public:
 Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);
public Task (Func<object,TResult> function, object state, System.Threading.Tasks.TaskCreationOptions creationOptions);
new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>
Public Sub New (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions)

Параметры

function
Func<Object,TResult>

Делегат, который представляет код, выполняемый в рамках задачи.The delegate that represents the code to execute in the task. После завершения выполнения функции для свойства задачи Result будет задано значение, равное значению, возвращенному функцией.When the function has completed, the task's Result property will be set to return the result value of the function.

state
Object Object Object Object

Объект, который представляет данные, используемые функцией.An object representing data to be used by the function.

creationOptions
TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions

Объект TaskCreationOptions, который используется для настройки поведения задачи.The TaskCreationOptions used to customize the task's behavior.

Исключения

Аргумент creationOptions задает недопустимое значение для TaskCreationOptions.The creationOptions argument specifies an invalid value for TaskCreationOptions.

Аргумент function имеет значение null.The function argument is null.

Аргумент function имеет значение null.The function argument is null.

Комментарии

Вместо вызова этого конструктора наиболее распространенным способом создания экземпляра Task<TResult> объекта и запуска задачи является вызов статического TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, TaskCreationOptions) метода.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, TaskCreationOptions) method. Единственным преимуществом, предоставляемым этим конструктором, является возможность разделения создания экземпляров объектов от вызова задач.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Дополнительно

Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions)

Инициализирует новую задачу Task<TResult> с указанной функцией и параметрами создания.Initializes a new Task<TResult> with the specified function and creation options.

public:
 Task(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions);
public Task (Func<TResult> function, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);
new System.Threading.Tasks.Task<'Result> : Func<'Result> * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Параметры

function
Func<TResult> Func<TResult> Func<TResult> Func<TResult>

Делегат, который представляет код, выполняемый в рамках задачи.The delegate that represents the code to execute in the task. После завершения выполнения функции для свойства задачи Result будет задано значение, равное значению, возвращенному функцией.When the function has completed, the task's Result property will be set to return the result value of the function.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Токен CancellationToken, который будет назначен новой задаче.The CancellationToken that will be assigned to the new task.

creationOptions
TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions

Объект TaskCreationOptions, который используется для настройки поведения задачи.The TaskCreationOptions used to customize the task's behavior.

Исключения

Класс CancellationTokenSource, создавший cancellationToken, уже удален.The CancellationTokenSource that created cancellationToken has already been disposed.

Аргумент creationOptions задает недопустимое значение для TaskCreationOptions.The creationOptions argument specifies an invalid value for TaskCreationOptions.

Аргумент function имеет значение null.The function argument is null.

Аргумент function имеет значение null.The function argument is null.

Комментарии

Вместо вызова этого конструктора наиболее распространенным способом создания экземпляра Task<TResult> объекта и запуска задачи является вызов статического TaskFactory.StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler) метода.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory.StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler) method. Единственным преимуществом, предоставляемым этим конструктором, является возможность разделения создания экземпляров объектов от вызова задач.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Дополнительно

Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions)

Инициализирует новую задачу Task<TResult> с заданными действием, состоянием и параметрами.Initializes a new Task<TResult> with the specified action, state, and options.

public:
 Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions);
public Task (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);
new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Параметры

function
Func<Object,TResult>

Делегат, который представляет код, выполняемый в рамках задачи.The delegate that represents the code to execute in the task. После завершения выполнения функции для свойства задачи Result будет задано значение, равное значению, возвращенному функцией.When the function has completed, the task's Result property will be set to return the result value of the function.

state
Object Object Object Object

Объект, который представляет данные, используемые функцией.An object representing data to be used by the function.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

Токен CancellationToken для назначения новой задаче.The CancellationToken to be assigned to the new task.

creationOptions
TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions

Объект TaskCreationOptions, который используется для настройки поведения задачи.The TaskCreationOptions used to customize the task's behavior.

Исключения

Класс CancellationTokenSource, создавший cancellationToken, уже удален.The CancellationTokenSource that created cancellationToken has already been disposed.

Аргумент creationOptions задает недопустимое значение для TaskCreationOptions.The creationOptions argument specifies an invalid value for TaskCreationOptions.

Аргумент function имеет значение null.The function argument is null.

Аргумент function имеет значение null.The function argument is null.

Комментарии

Вместо вызова этого конструктора наиболее распространенным способом создания экземпляра Task<TResult> объекта и запуска задачи является вызов статического TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler) метода.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler) method. Единственным преимуществом, предоставляемым этим конструктором, является возможность разделения создания экземпляров объектов от вызова задач.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Дополнительно

Применяется к