TaskCreationOptions Énumération

Définition

Espace de noms:
System.Threading.Tasks
Assemblys:
mscorlib.dll, System.Threading.Tasks.dll
Assembly:
mscorlib.dll
Assembly:
System.Threading.Tasks.dll
Assembly:
netstandard.dll

Spécifie des indicateurs qui contrôlent le comportement facultatif pour la création et l’exécution de tâches.

Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.

public enum class TaskCreationOptions
[System.Flags]
public enum TaskCreationOptions
[System.Flags]
[System.Serializable]
public enum TaskCreationOptions
[<System.Flags>]
type TaskCreationOptions = 
[<System.Flags>]
[<System.Serializable>]
type TaskCreationOptions = 
Public Enum TaskCreationOptions
Héritage
Object
ValueType
Enum
TaskCreationOptions
Attributs
FlagsAttribute SerializableAttribute

Champs

Nom Valeur Description
None 0

Spécifie que le comportement par défaut doit être utilisé.
PreferFairness 1

Un indicateur pour planifier TaskScheduler une tâche de manière aussi équitable que possible, ce qui signifie que les tâches planifiées plus tôt seront plus susceptibles d’être exécutées plus tôt, et les tâches planifiées ultérieurement seront plus susceptibles d’être exécutées ultérieurement.
LongRunning 2

Spécifie qu’une tâche sera une opération longue et grossière impliquant moins de composants plus grands que les systèmes affinés. Il fournit un indicateur au fait que la TaskScheduler sursubscription peut être justifiée. Oversubscription vous permet de créer plus de threads que le nombre disponible de threads matériels. Il fournit également un indicateur au planificateur de tâches qu’un thread supplémentaire peut être requis pour la tâche afin qu’elle ne bloque pas la progression vers l’avant d’autres threads ou éléments de travail dans la file d’attente du pool de threads local.
AttachedToParent 4

Spécifie qu’une tâche est attachée à un parent dans la hiérarchie des tâches. Par défaut, une tâche enfant (autrement dit, une tâche interne créée par une tâche externe) s’exécute indépendamment de son parent. Vous pouvez utiliser l’option AttachedToParent pour que les tâches parent et enfant soient synchronisées.

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.

Pour plus d'informations, consultez Tâches enfants attachées et détachées.
DenyChildAttach 8

Spécifie que toute tâche enfant qui tente d’s’exécuter en tant que tâche enfant jointe (autrement dit, elle est créée avec l’option AttachedToParent ) ne pourra pas s’attacher à la tâche parente et s’exécutera en tant que tâche enfant détachée. Pour plus d'informations, consultez Tâches enfants attachées et détachées.
HideScheduler 16

Empêche le planificateur ambiant d’être considéré comme le planificateur actuel dans la tâche créée. Cela signifie que les opérations telles que StartNew ou ContinueWith effectuées dans la tâche créée voient Default comme planificateur actuel.
RunContinuationsAsynchronously 64

Force l’exécution asynchrone des continuations à la tâche actuelle.

Notez que le membre RunContinuationsAsynchronously est disponible dans l’énumération TaskCreationOptions à partir du .NET Framework 4.6.

Remarques

L’énumération TaskCreationOptions est utilisée avec les méthodes suivantes :

  • Les TaskFactory constructeurs et TaskFactory<TResult> les constructeurs 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.

  • Les Task constructeurs et Task<TResult> les constructeurs avec un creationOptions paramètre, pour spécifier les options utilisées pour personnaliser le comportement de la tâche.

  • Méthodes StartNew et StartNew méthodes avec un creationOptions paramètre, pour spécifier les options utilisées pour personnaliser le comportement de la tâche.

  • Méthodes FromAsync et FromAsync méthodes avec un creationOptions paramètre, pour spécifier les options utilisées pour personnaliser le comportement de la tâche qui exécute une méthode de fin lorsqu’une méthode spécifiée IAsyncResult est terminée.

  • Constructeurs TaskCompletionSource<TResult> avec un creationOptions paramètre, pour spécifier les options utilisées pour personnaliser le comportement de la tâche sous-jacente.

S’applique à

Voir aussi