TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions Enum

Определение

Задает флаги, которые управляют необязательным поведением создания и выполнения задач.Specifies flags that control optional behavior for the creation and execution of tasks.

Это перечисление имеет атрибут FlagsAttribute, который разрешает побитовое сочетание значений его элементов.

public enum class TaskCreationOptions
[System.Flags]
[System.Serializable]
public enum TaskCreationOptions
type TaskCreationOptions = 
Public Enum TaskCreationOptions
Наследование
TaskCreationOptionsTaskCreationOptionsTaskCreationOptionsTaskCreationOptions
Атрибуты

Поля

AttachedToParent AttachedToParent AttachedToParent AttachedToParent 4

Указывает, что задача присоединена к родительской задаче в иерархии задач.Specifies that a task is attached to a parent in the task hierarchy. По умолчанию дочерняя задача (это внутренняя задача, создаваемая внешней задачей) выполняется независимо от своей родительской задачи.By default, a child task (that is, an inner task created by an outer task) executes independently of its parent. Вы можете воспользоваться параметром AttachedToParent, чтобы синхронизировать родительские и дочерние задачи.You can use the AttachedToParent option so that the parent and child tasks are synchronized.

Обратите внимание, что если родительская задача настроена с параметром DenyChildAttach, параметр AttachedToParent в дочерней задаче не действует, и эта дочерняя задача будет выполняться как отсоединенная.Note that if a parent task is configured with the DenyChildAttach option, the AttachedToParent option in the child task has no effect, and the child task will execute as a detached child task.

Дополнительные сведения см. в разделе Присоединенные и отсоединенные дочерние задачи.For more information, see Attached and Detached Child Tasks.

DenyChildAttach DenyChildAttach DenyChildAttach DenyChildAttach 8

Указывает, что любая дочерняя задача, для которой выполняется попытка выполнения в качестве подсоединенной дочерней задачи (т. е. она создается с параметром AttachedToParent), не сможет подключиться к родительской задаче и будет выполняться как отсоединенная дочерняя задача.Specifies that any child task that attempts to execute as an attached child task (that is, it is created with the AttachedToParent option) will not be able to attach to the parent task and will execute instead as a detached child task. Дополнительные сведения см. в разделе Присоединенные и отсоединенные дочерние задачи.For more information, see Attached and Detached Child Tasks.

HideScheduler HideScheduler HideScheduler HideScheduler 16

Не позволяет видеть внешний планировщик как текущий планировщик в созданной задаче.Prevents the ambient scheduler from being seen as the current scheduler in the created task. Это означает, что такие операции, как StartNew или ContinueWith, которые выполняются в созданной задаче, в качестве текущего планировщика будут видеть свойство Default.This means that operations like StartNew or ContinueWith that are performed in the created task will see Default as the current scheduler.

LongRunning LongRunning LongRunning LongRunning 2

Указывает, что задача будет выполняться долго в качестве общей операции, включающей еще несколько компонентов, по размеру превышающих детализированные системы.Specifies that a task will be a long-running, coarse-grained operation involving fewer, larger components than fine-grained systems. Предоставляет сведения для TaskScheduler, что следует ожидать избыточной подписки.It provides a hint to the TaskScheduler that oversubscription may be warranted. Превышение лимита подписки позволяет создать больше потоков, чем количество доступных аппаратных потоков.Oversubscription lets you create more threads than the available number of hardware threads. Он также подсказывает планировщику задач, что для задачи может потребоваться дополнительный поток, чтобы она не блокировала дальнейший ход работы других потоков или рабочих элементов в локальной очереди пула потоков.It also provides a hint to the task scheduler that an additional thread might be required for the task so that it does not block the forward progress of other threads or work items on the local thread-pool queue.

None None None None 0

Указывает, что следует использовать поведение по умолчанию.Specifies that the default behavior should be used.

PreferFairness PreferFairness PreferFairness PreferFairness 1

Рекомендация для TaskScheduler для планирования задач максимально прямым способом, то есть задачи, запланированные ранее, будут выполняться ранее, а более поздние — позднее.A hint to a TaskScheduler to schedule a task in as fair a manner as possible, meaning that tasks scheduled sooner will be more likely to be run sooner, and tasks scheduled later will be more likely to be run later.

RunContinuationsAsynchronously RunContinuationsAsynchronously RunContinuationsAsynchronously RunContinuationsAsynchronously 64

Принудительное асинхронное выполнение продолжений, добавляемых в текущую задачу.Forces continuations added to the current task to be executed asynchronously.

Обратите внимание, что элемент RunContinuationsAsynchronously доступен в перечислении TaskCreationOptions, начиная с .NET Framework 4.6.NET Framework 4.6.Note that the RunContinuationsAsynchronously member is available in the TaskCreationOptions enumeration starting with the .NET Framework 4.6.NET Framework 4.6.

Комментарии

TaskCreationOptions Перечисление используется со следующими методами.The TaskCreationOptions enumeration is used with the following methods:

  • Конструкторы TaskFactory<TResult> исcreationOptions параметром для указания параметров по умолчанию для задач, создаваемых фабрикой задач. TaskFactoryThe TaskFactory and TaskFactory<TResult> constructors with a creationOptions parameter, to specify the default options for tasks created by the task factory.

  • Конструкторы Task<TResult> исcreationOptions параметром для указания параметров, используемых для настройки поведения задачи. TaskThe Task and Task<TResult> constructors with a creationOptions parameter, to specify the options used to customize the task's behavior.

  • Методы StartNew и StartNew сcreationOptions параметром для указания параметров, используемых для настройки поведения задачи.The StartNew and StartNew methods with a creationOptions parameter, to specify the options used to customize the task's behavior.

  • Методы FromAsync IAsyncResult и FromAsync с параметром используются для указания параметров, используемых для настройки поведения задачи, выполняющей метод End, когда заданное завершение завершается. creationOptionsThe FromAsync and FromAsync methods with a creationOptions parameter, to specify the options used to customize the behavior of the task that executes an end method when a specified IAsyncResult completes.

  • КонструкторыcreationOptions с параметром для указания параметров, используемых для настройки поведения базовой задачи. TaskCompletionSource<TResult>The TaskCompletionSource<TResult> constructors with a creationOptions parameter, to specify the options used to customize the behavior of the underlying task.

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

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