Partager via

TaskCreationOptions Énumération

  • Référence

Définition

Espace de noms:
System.Threading.Tasks
Assembly:
System.Threading.Tasks.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.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

AttachedToParent 4

Spécifie qu’une tâche est associé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) est exécutée indépendamment de son parent. Vous pouvez utiliser l'option AttachedToParent pour que les tâches parente 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

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. 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 considéreront Default comme planificateur actuel.
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. Conseille au TaskScheduler de garantir le surabonnement. Le surabonnement vous permet de créer un nombre de threads plus important que le nombre de threads matériels disponibles. Il fournit également un indicateur au planificateur de tâches qu’un thread supplémentaire peut être nécessaire pour la tâche afin qu’il ne bloque pas la progression d’autres threads ou éléments de travail dans la file d’attente du pool de threads local.
None 0

Indique que le comportement par défaut doit être utilisé.
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.
RunContinuationsAsynchronously 64

Force l'exécution asynchrone des continuations ajoutées à la tâche actuelle.

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

Remarques

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

  • Constructeurs TaskFactory et TaskFactory<TResult> 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.

  • Constructeurs Task et Task<TResult> 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 avec un creationOptions paramètre , pour spécifier les options utilisées pour personnaliser le comportement de la tâche.

  • Les FromAsync méthodes et FromAsync 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’un spécifié IAsyncResult se termine.

  • 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