TaskFactory<TResult>.StartNew Метод

Определение

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

System.Threading.Tasks

Сборка:

System.Threading.Tasks.dll

Сборка:

System.Runtime.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.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)

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

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);

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)
• Использование библиотеки параллельных задач с другими асинхронными шаблонами

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

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

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);

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)
• Использование библиотеки параллельных задач с другими асинхронными шаблонами

StartNew(Func<TResult>, TaskCreationOptions)

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

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)
• Использование библиотеки параллельных задач с другими асинхронными шаблонами

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

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

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)
• Использование библиотеки параллельных задач с другими асинхронными шаблонами

StartNew(Func<Object,TResult>, Object)

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

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);

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)
• Использование библиотеки параллельных задач с другими асинхронными шаблонами

StartNew(Func<TResult>)

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

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)
• Использование библиотеки параллельных задач с другими асинхронными шаблонами

StartNew(Func<TResult>, CancellationToken)

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

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)
• Использование библиотеки параллельных задач с другими асинхронными шаблонами

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

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

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);

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)
• Использование библиотеки параллельных задач с другими асинхронными шаблонами