TaskFactory<TResult>.StartNew Метод

Определение

Пространство имен:

System.Threading.Tasks

Сборки:

netstandard.dll, System.Runtime.dll

Создает и запускает задачу.

Перегрузки

Имя	Описание
StartNew(Func<Object,TResult>, Object, CancellationToken)	Создает и запускает задачу.
StartNew(Func<Object,TResult>, Object, TaskCreationOptions)	Создает и запускает задачу.
StartNew(Func<TResult>, TaskCreationOptions)	Создает и запускает задачу.
StartNew(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)	Создает и запускает задачу.
StartNew(Func<Object,TResult>, Object)	Создает и запускает задачу.
StartNew(Func<TResult>)	Создает и запускает задачу.
StartNew(Func<TResult>, CancellationToken)	Создает и запускает задачу.
StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	Создает и запускает задачу.

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

Исходный код:

FutureFactory.cs

Создает и запускает задачу.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> StartNew(Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken) As Task(Of TResult)

Параметры

function

Func<Object,TResult>

Делегат функции, возвращающий будущий результат, который будет доступен через задачу.

state

Object

Объект, содержащий данные, используемые делегатом function .

cancellationToken

CancellationToken

Маркер отмены, которому будет назначена новая задача.

Возвращаемое значение

Task<TResult>

Запущенная задача.

Исключения

ObjectDisposedException

Созданный источник cancellationToken маркера отмены уже удален.

ArgumentNullException

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

Комментарии

Вызов StartNew функционально эквивалентен созданию задачи с помощью одного из Task<TResult> конструкторов, а затем вызывает Start метод для планирования выполнения.

Однако, если создание и планирование не должны быть разделены, рекомендуется использовать как для простоты, StartNew так и для производительности.

См. также раздел

• Библиотека параллельных задач (TPL)
• Использование TPL с другими асинхронными шаблонами

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

Исходный код:

FutureFactory.cs

Создает и запускает задачу.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task<TResult> StartNew(Func<object?,TResult> function, object? state, System.Threading.Tasks.TaskCreationOptions creationOptions);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions) As Task(Of TResult)

Параметры

function

Func<Object,TResult>

Делегат функции, возвращающий будущий результат, который будет доступен через задачу.

state

Object

Объект, содержащий данные, используемые делегатом function .

creationOptions

TaskCreationOptions

Одно из значений перечисления, которое управляет поведением созданной задачи.

Возвращаемое значение

Task<TResult>

Запущенная задача.

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

Параметр creationOptions задает недопустимое значение.

Комментарии

Вызов StartNew функционально эквивалентен созданию задачи с помощью одного из Task<TResult> конструкторов, а затем вызывает Start метод для планирования выполнения.

Однако, если создание и планирование не должны быть разделены, рекомендуется использовать как для простоты, StartNew так и для производительности.

См. также раздел

• Библиотека параллельных задач (TPL)
• Использование TPL с другими асинхронными шаблонами

StartNew(Func<TResult>, TaskCreationOptions)

Исходный код:

FutureFactory.cs

Создает и запускает задачу.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task<TResult> StartNew(Func<TResult> function, System.Threading.Tasks.TaskCreationOptions creationOptions);

member this.StartNew : Func<'Result> * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), creationOptions As TaskCreationOptions) As Task(Of TResult)

Параметры

function

Func<TResult>

Делегат функции, возвращающий будущий результат, который будет доступен через задачу.

creationOptions

TaskCreationOptions

Одно из значений перечисления, которое управляет поведением созданной задачи.

Возвращаемое значение

Task<TResult>

Начало Task<TResult>.

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

Параметр creationOptions задает недопустимое значение.

Комментарии

Вызов StartNew функционально эквивалентен созданию задачи с помощью одного из Task<TResult> конструкторов, а затем вызывает Start метод для планирования выполнения.

Однако, если создание и планирование не должны быть разделены, рекомендуется использовать как для простоты, StartNew так и для производительности.

См. также раздел

• Библиотека параллельных задач (TPL)
• Использование TPL с другими асинхронными шаблонами

StartNew(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)

Исходный код:

FutureFactory.cs

Создает и запускает задачу.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TResult> StartNew(Func<TResult> function, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.StartNew : Func<'Result> * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

Параметры

function

Func<TResult>

Делегат функции, возвращающий будущий результат, который будет доступен через задачу.

cancellationToken

CancellationToken

Маркер отмены, которому будет назначена новая задача.

creationOptions

TaskCreationOptions

Одно из значений перечисления, которое управляет поведением созданной задачи.

scheduler

TaskScheduler

Планировщик задач, используемый для планирования созданной задачи.

Возвращаемое значение

Task<TResult>

Запущенная задача.

Исключения

ObjectDisposedException

Созданный источник cancellationToken маркера отмены уже удален.

ArgumentNullException

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

–или–

Аргумент scheduler имеет значение null.

ArgumentOutOfRangeException

Параметр creationOptions задает недопустимое значение.

Комментарии

Вызов StartNew функционально эквивалентен созданию задачи с помощью одного из Task<TResult> конструкторов, а затем вызывает Start метод для планирования выполнения.

Однако, если создание и планирование не должны быть разделены, рекомендуется использовать как для простоты, StartNew так и для производительности.

См. также раздел

• Библиотека параллельных задач (TPL)
• Использование TPL с другими асинхронными шаблонами

StartNew(Func<Object,TResult>, Object)

Исходный код:

FutureFactory.cs

Создает и запускает задачу.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state);

public System.Threading.Tasks.Task<TResult> StartNew(Func<object?,TResult> function, object? state);

member this.StartNew : Func<obj, 'Result> * obj -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object) As Task(Of TResult)

Параметры

function

Func<Object,TResult>

Делегат функции, возвращающий будущий результат, который будет доступен через задачу.

state

Object

Объект, содержащий данные, используемые делегатом function .

Возвращаемое значение

Task<TResult>

Запущенная задача.

Исключения

ArgumentNullException

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

Комментарии

Вызов StartNew функционально эквивалентен созданию задачи с помощью одного из Task<TResult> конструкторов, а затем вызывает Start метод для планирования выполнения.

Однако, если создание и планирование не должны быть разделены, рекомендуется использовать как для простоты, StartNew так и для производительности.

См. также раздел

• Библиотека параллельных задач (TPL)
• Использование TPL с другими асинхронными шаблонами

StartNew(Func<TResult>)

Исходный код:

FutureFactory.cs

Создает и запускает задачу.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function);

public System.Threading.Tasks.Task<TResult> StartNew(Func<TResult> function);

member this.StartNew : Func<'Result> -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult)) As Task(Of TResult)

Параметры

function

Func<TResult>

Делегат функции, возвращающий будущий результат, который будет доступен через задачу.

Возвращаемое значение

Task<TResult>

Запущенная задача.

Исключения

ArgumentNullException

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

Комментарии

Вызов StartNew функционально эквивалентен созданию задачи с помощью одного из Task<TResult> конструкторов, а затем вызывает Start метод для планирования выполнения.

Однако, если создание и планирование не должны быть разделены, рекомендуется использовать как для простоты, StartNew так и для производительности.

См. также раздел

• Библиотека параллельных задач (TPL)
• Использование TPL с другими асинхронными шаблонами

StartNew(Func<TResult>, CancellationToken)

Исходный код:

FutureFactory.cs

Создает и запускает задачу.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> StartNew(Func<TResult> function, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Func<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), cancellationToken As CancellationToken) As Task(Of TResult)

Параметры

function

Func<TResult>

Делегат функции, возвращающий будущий результат, который будет доступен через задачу.

cancellationToken

CancellationToken

Маркер отмены, которому будет назначена новая задача.

Возвращаемое значение

Task<TResult>

Запущенная задача.

Исключения

ObjectDisposedException

Созданный источник cancellationToken маркера отмены уже удален.

ArgumentNullException

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

Комментарии

Вызов StartNew функционально эквивалентен созданию задачи с помощью одного из Task<TResult> конструкторов, а затем вызывает Start метод для планирования выполнения.

Однако, если создание и планирование не должны быть разделены, рекомендуется использовать как для простоты, StartNew так и для производительности.

См. также раздел

• Библиотека параллельных задач (TPL)
• Использование TPL с другими асинхронными шаблонами

StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)

Исходный код:

FutureFactory.cs

Создает и запускает задачу.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TResult> StartNew(Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

Параметры

function

Func<Object,TResult>

Делегат функции, возвращающий будущий результат, который будет доступен через задачу.

state

Object

Объект, содержащий данные, используемые делегатом function .

cancellationToken

CancellationToken

Маркер отмены, которому будет назначена новая задача.

creationOptions

TaskCreationOptions

Одно из значений перечисления, которое управляет поведением созданной задачи.

scheduler

TaskScheduler

Планировщик задач, используемый для планирования созданной задачи.

Возвращаемое значение

Task<TResult>

Запущенная задача.

Исключения

ObjectDisposedException

Созданный источник cancellationToken маркера отмены уже удален.

ArgumentNullException

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

–или–

Аргумент scheduler имеет значение null.

ArgumentOutOfRangeException

Параметр creationOptions задает недопустимое значение.

Комментарии

Вызов StartNew функционально эквивалентен созданию задачи с помощью одного из Task<TResult> конструкторов, а затем вызывает Start метод для планирования выполнения.

Однако, если создание и планирование не должны быть разделены, рекомендуется использовать как для простоты, StartNew так и для производительности.

См. также раздел

• Библиотека параллельных задач (TPL)
• Использование TPL с другими асинхронными шаблонами