TaskCreationOptions Énumération

Définition

Spécifie des indicateurs qui contrôlent le comportement facultatif pour la création et l'exécution de tâches.Specifies flags that control optional behavior for the creation and execution of tasks.

Cette énumération a un attribut FlagsAttribute qui permet une combinaison au niveau du bit de ses valeurs membres.

public enum class TaskCreationOptions
[System.Flags]
[System.Serializable]
public enum TaskCreationOptions
type TaskCreationOptions = 
Public Enum TaskCreationOptions
Héritage
TaskCreationOptions
Attributs

Champs

AttachedToParent 4

Spécifie qu’une tâche est associée à un parent dans la hiérarchie des tâches.Specifies that a task is attached to a parent in the task hierarchy. Par défaut, une tâche enfant (autrement dit, une tâche interne créée par une tâche externe) est exécutée indépendamment de son parent.By default, a child task (that is, an inner task created by an outer task) executes independently of its parent. Vous pouvez utiliser l'option AttachedToParent pour que les tâches parente et enfant soient synchronisées.You can use the AttachedToParent option so that the parent and child tasks are synchronized.

Notez que si une tâche parente est configurée avec l'option DenyChildAttach, l'option AttachedToParent de la tâche enfant n'a aucun effet, et la tâche enfant s'exécute en tant que tâche enfant détachée.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.

Pour plus d’informations, consultez Tâches enfants attachées et détachées.For more information, see Attached and Detached Child Tasks.

DenyChildAttach 8

Indique qu'une tâche enfant qui tente de s'exécuter comme une tâche enfant détachée (c'est-à-dire créée avec l'option AttachedToParent) ne peut pas être attachée à la tâche parente et s'exécute à la place comme tâche enfant détachée.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. Pour plus d'informations, consultez Tâches enfants attachées et détachées.For more information, see Attached and Detached Child Tasks.

HideScheduler 16

Empêche le planificateur ambiant d'être considéré comme le planificateur actuel dans la tâche créée.Prevents the ambient scheduler from being seen as the current scheduler in the created task. Cela signifie que les opérations telles que StartNew ou ContinueWith effectuées dans la tâche créée considéreront Default comme planificateur actuel.This means that operations like StartNew or ContinueWith that are performed in the created task will see Default as the current scheduler.

LongRunning 2

Indique qu'une tâche sera une opération de longue durée et de granulosité grossière impliquant moins de composants importants que les systèmes affinés.Specifies that a task will be a long-running, coarse-grained operation involving fewer, larger components than fine-grained systems. Conseille au TaskScheduler de garantir le surabonnement.It provides a hint to the TaskScheduler that oversubscription may be warranted. Le surabonnement vous permet de créer un nombre de threads plus important que le nombre de threads matériels disponibles.Oversubscription lets you create more threads than the available number of hardware threads. Il indique également au Planificateur de tâches qu’un thread supplémentaire peut être nécessaire à la tâche afin qu’elle n’entrave pas la progression d’autres threads ou éléments de travail sur la file d’attente de pools de threads locale.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 0

Indique que le comportement par défaut doit être utilisé.Specifies that the default behavior should be used.

PreferFairness 1

Conseil à un TaskScheduler pour planifier une tâche d'une façon aussi juste que possible. Les tâches planifiées plus tôt seront probablement exécutées plus tôt et celles planifiées plus tard seront probablement exécutées ultérieurement.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 64

Force l'exécution asynchrone des continuations ajoutées à la tâche actuelle.Forces continuations added to the current task to be executed asynchronously.

Notez que le membre RunContinuationsAsynchronously est disponible dans l’énumération TaskCreationOptions à compter de .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.

Remarques

L' TaskCreationOptions énumération est utilisée avec les méthodes suivantes:The TaskCreationOptions enumeration is used with the following methods:

  • Les TaskFactory constructeurs TaskFactory<TResult> et avec un creationOptions paramètre pour spécifier les options par défaut pour les tâches créées par la fabrique de tâches.The TaskFactory and TaskFactory<TResult> constructors with a creationOptions parameter, to specify the default options for tasks created by the task factory.

  • Les Task constructeurs Task<TResult> et avec un creationOptions paramètre pour spécifier les options utilisées pour personnaliser le comportement de la tâche.The Task and Task<TResult> constructors with a creationOptions parameter, to specify the options used to customize the task's behavior.

  • Les StartNew méthodes StartNew et avec un creationOptions paramètre permettent de spécifier les options utilisées pour personnaliser le comportement de la tâche.The StartNew and StartNew methods with a creationOptions parameter, to specify the options used to customize the task's behavior.

  • Les FromAsync méthodes FromAsync et avec un creationOptions paramètre permettent de spécifier les options utilisées pour personnaliser le comportement de la tâche qui exécute une méthode End quand un spécifié IAsyncResult se termine.The 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.

  • Constructeurs avec un creationOptions paramètre pour spécifier les options utilisées pour personnaliser le comportement de la tâche sous-jacente. TaskCompletionSource<TResult>The TaskCompletionSource<TResult> constructors with a creationOptions parameter, to specify the options used to customize the behavior of the underlying task.

S’applique à

Voir aussi