Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Dispatcher classe

 

Date de publication : novembre 2016

Fournit des services de gestion de la file d’attente des éléments de travail pour un thread.

Espace de noms:   System.Windows.Threading
Assembly:  WindowsBase (dans WindowsBase.dll)

System.Object
  System.Windows.Threading.Dispatcher

public sealed class Dispatcher

NomDescription
System_CAPS_pubpropertySystem_CAPS_staticCurrentDispatcher

Obtient le Dispatcher pour le thread en cours d’exécution et crée un objet Dispatcher Si aucun n’est pas déjà associé au thread.

System_CAPS_pubpropertyHasShutdownFinished

Détermine si le Dispatcher arrêt a abouti.

System_CAPS_pubpropertyHasShutdownStarted

Détermine si le Dispatcher s’arrête.

System_CAPS_pubpropertyHooks

Obtient la collection de raccordements qui fournissent des informations d’événement supplémentaires sur le Dispatcher.

System_CAPS_pubpropertyThread

Obtient le thread ce Dispatcher est associé.

NomDescription
System_CAPS_pubmethodBeginInvoke(Delegate, DispatcherPriority, Object[])

Exécute le délégué spécifié de façon asynchrone avec les arguments spécifiés, à la priorité spécifiée, sur le thread qui le Dispatcher a été créé.

System_CAPS_pubmethodBeginInvoke(Delegate, Object[])

Exécute le délégué spécifié de façon asynchrone avec les arguments spécifiés sur le thread qui le Dispatcher a été créé.

System_CAPS_pubmethodBeginInvoke(DispatcherPriority, Delegate)

Exécute le délégué spécifié de façon asynchrone à la priorité spécifiée sur le thread du Dispatcher est associé.

System_CAPS_pubmethodBeginInvoke(DispatcherPriority, Delegate, Object)

Exécute le délégué spécifié de façon asynchrone à la priorité spécifiée et avec l’argument spécifié sur le thread du Dispatcher est associé.

System_CAPS_pubmethodBeginInvoke(DispatcherPriority, Delegate, Object, Object[])

Exécute le délégué spécifié de façon asynchrone à la priorité spécifiée et avec le tableau d’arguments spécifié sur le thread du Dispatcher est associé.

System_CAPS_pubmethodBeginInvokeShutdown(DispatcherPriority)

Arrêt de lance de la Dispatcher en mode asynchrone.

System_CAPS_pubmethodCheckAccess()

Détermine si le thread appelant est le thread associé à ce Dispatcher.

System_CAPS_pubmethodDisableProcessing()

Désactive le traitement de la Dispatcher file d’attente.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodSystem_CAPS_staticExitAllFrames()

Requêtes qui s’arrêtent de tous les frames, y compris les blocs imbriqués.

System_CAPS_pubmethodSystem_CAPS_staticFromThread(Thread)

Obtient le Dispatcher pour le thread spécifié.

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodInvoke(Action)

Exécute la commande spécifiée Action synchrone sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke(Action, DispatcherPriority)

Exécute la commande spécifiée Action synchrone à la priorité spécifiée sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke(Action, DispatcherPriority, CancellationToken)

Exécute la commande spécifiée Action synchrone à la priorité spécifiée sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke(Action, DispatcherPriority, CancellationToken, TimeSpan)

Exécute la commande spécifiée Action synchrone à la priorité spécifiée sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke(Delegate, DispatcherPriority, Object[])

Exécute de façon synchrone le délégué spécifié à la priorité spécifiée avec les arguments spécifiés sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke(Delegate, Object[])

Exécute de façon synchrone le délégué spécifié avec les arguments spécifiés sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke(Delegate, TimeSpan, DispatcherPriority, Object[])

Exécute de façon synchrone le délégué spécifié dans l’intervalle de temps spécifié à la priorité spécifiée avec les arguments spécifiés sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke(Delegate, TimeSpan, Object[])

Exécute de façon synchrone le délégué spécifié dans l’intervalle de temps spécifié à la priorité spécifiée avec les arguments spécifiés sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke(DispatcherPriority, Delegate)

Exécute le délégué spécifié de façon synchrone selon la priorité spécifiée sur le thread sur lequel le Dispatcher est associé.

System_CAPS_pubmethodInvoke(DispatcherPriority, Delegate, Object)

Exécute le délégué spécifié à la priorité spécifiée avec l’argument spécifié de façon synchrone sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke(DispatcherPriority, Delegate, Object, Object[])

Exécute de façon synchrone le délégué spécifié à la priorité spécifiée avec les arguments spécifiés sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke(DispatcherPriority, TimeSpan, Delegate)

Exécute le délégué spécifié de façon synchrone selon la priorité spécifiée et avec la valeur de délai d’attente spécifié sur le thread du Dispatcher a été créé.

System_CAPS_pubmethodInvoke(DispatcherPriority, TimeSpan, Delegate, Object)

Exécute le délégué spécifié à la priorité spécifiée avec l’argument spécifié de façon synchrone sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke(DispatcherPriority, TimeSpan, Delegate, Object, Object[])

Exécute de façon synchrone le délégué spécifié à la priorité spécifiée avec les arguments spécifiés sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke<TResult>(Func<TResult>)

Exécute la commande spécifiée Func<TResult> synchrone sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke<TResult>(Func<TResult>, DispatcherPriority)

Exécute la commande spécifiée Func<TResult> synchrone à la priorité spécifiée sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke<TResult>(Func<TResult>, DispatcherPriority, CancellationToken)

Exécute la commande spécifiée Func<TResult> synchrone à la priorité spécifiée sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvoke<TResult>(Func<TResult>, DispatcherPriority, CancellationToken, TimeSpan)

Exécute la commande spécifiée Func<TResult> synchrone à la priorité spécifiée sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvokeAsync(Action)

Exécute la commande spécifiée Action asynchrone sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvokeAsync(Action, DispatcherPriority)

Exécute la commande spécifiée Action asynchrone à la priorité spécifiée sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvokeAsync(Action, DispatcherPriority, CancellationToken)

Exécute la commande spécifiée Action asynchrone à la priorité spécifiée sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvokeAsync<TResult>(Func<TResult>)

Exécute la commande spécifiée Func<TResult> asynchrone sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvokeAsync<TResult>(Func<TResult>, DispatcherPriority)

Exécute la commande spécifiée Func<TResult> asynchrone à la priorité spécifiée sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvokeAsync<TResult>(Func<TResult>, DispatcherPriority, CancellationToken)

Exécute la commande spécifiée Func<TResult> synchrone à la priorité spécifiée sur le thread du Dispatcher est associé.

System_CAPS_pubmethodInvokeShutdown()

Lance le processus d’arrêt de la Dispatcher synchrone.

System_CAPS_pubmethodSystem_CAPS_staticPushFrame(DispatcherFrame)

Insère une boucle d’exécution.

System_CAPS_pubmethodSystem_CAPS_staticRun()

Exécute un push du frame d’exécution principal sur la file d’attente de la Dispatcher.

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodSystem_CAPS_staticValidatePriority(DispatcherPriority, String)

Détermine si le texte spécifié DispatcherPriority est une priorité valide.

System_CAPS_pubmethodVerifyAccess()

Détermine si le thread appelant a accès à ce Dispatcher.

System_CAPS_pubmethodSystem_CAPS_staticYield()

Crée un objet pouvant être qui cède le contrôle au répartiteur actuel de manière asynchrone et fournit une opportunité pour le répartiteur à traiter d’autres événements.

System_CAPS_pubmethodSystem_CAPS_staticYield(DispatcherPriority)

Crée un objet pouvant être qui cède le contrôle au répartiteur actuel de manière asynchrone et fournit une opportunité pour le répartiteur à traiter d’autres événements. Le travail qui se produit lorsque le contrôle retourne au code attendre le résultat de cette méthode est planifié avec la priorité spécifiée.

NomDescription
System_CAPS_pubeventShutdownFinished

Se produit lorsque le Dispatcher termine l’arrêt.

System_CAPS_pubeventShutdownStarted

Se produit lorsque le Dispatcher commence à s’est arrêté.

System_CAPS_pubeventUnhandledException

Se produit lorsqu’une exception de thread est levée et non interceptée pendant l’exécution d’un délégué au moyen de Invoke ou BeginInvoke.

System_CAPS_pubeventUnhandledExceptionFilter

Se produit lorsqu’une exception de thread est levée et non interceptée pendant l’exécution d’un délégué au moyen de Invoke ou BeginInvoke lors de l’étape de filtrage.

NomDescription
System_CAPS_pubmethodBeginInvoke(Action)

Surchargé. Exécute le délégué spécifié de façon asynchrone avec une priorité normale sur le thread qui spécifié Dispatcher a été créé.(Défini par DispatcherExtensions.)

System_CAPS_pubmethodBeginInvoke(Action, DispatcherPriority)

Surchargé. Exécute le délégué spécifié de façon asynchrone avec la priorité spécifiée sur le thread qui spécifié Dispatcher a été créé.(Défini par DispatcherExtensions.)

System_CAPS_pubmethodInvoke(Action, TimeSpan)

Surchargé. Exécute le délégué spécifié de façon synchrone sur le thread qui spécifié Dispatcher a été créé et arrête l’exécution après le délai d’attente spécifié.(Défini par DispatcherExtensions.)

System_CAPS_pubmethodInvoke(Action, TimeSpan, DispatcherPriority)

Surchargé. Exécute le délégué spécifié de façon synchrone avec la priorité spécifiée sur le thread qui spécifié Dispatcher a été créé et arrête l’exécution après le délai d’attente spécifié.(Défini par DispatcherExtensions.)

Le Dispatcher maintient une file d’attente de priorité des éléments de travail pour un thread spécifique.

Lorsqu’un Dispatcher est créé sur un thread, il devient le seul Dispatcher qui peut être associé au thread, même si la Dispatcher est arrêté.

Si vous tentez d’obtenir le CurrentDispatcher pour le thread actuel et un Dispatcher n’est pas associé au thread, un Dispatcher est créé. Un Dispatcher est également créée lorsque vous créez un DispatcherObject. Si vous créez un Dispatcher sur un thread d’arrière-plan, veillez à arrêter le répartiteur avant de quitter le thread.

Si un Dispatcher est arrêté, il ne peut pas être redémarré.

Dans WPF, un DispatcherObject est accessible uniquement par le Dispatcher lui est associée.  Par exemple, un thread d’arrière-plan ne peut pas mettre à jour le contenu d’un Button qui est associé le Dispatcher sur la Interface utilisateur thread. Afin que le thread d’arrière-plan pour accéder à la Content propriété de la Button, le thread d’arrière-plan doit déléguer le travail pour le Dispatcher associé à la Interface utilisateur thread. Cela est accompli à l’aide Invoke ou BeginInvoke. Invoke est synchrone et BeginInvoke est asynchrone. L’opération est ajoutée à la file d’attente de la Dispatcher à l’emplacement spécifié DispatcherPriority.

Si BeginInvoke est appelée sur une Dispatcher qui s’est arrêté, la propriété status de retourné DispatcherOperation est définie sur Aborted.

Toutes les méthodes sur Dispatcher, à l’exception de DisableProcessing, sont libres de threads.

Les objets qui dérivent de DispatcherObject ont une affinité de thread.

Les objets qui dérivent de Freezable sont libres de threads lorsqu’ils sont figés. Pour plus d’informations, consultez vue d’ensemble des objets Freezable.

L’exemple suivant montre comment placer une opération sur un Dispatcher. Pour le code source complet de cet exemple, consultez la page Single-Threaded Application with Long-Running Calculation Sample.

Tout d’abord, un délégué est créé qui n’accepte aucun argument.

public delegate void NextPrimeDelegate();

Ensuite, BeginInvoke(DispatcherPriority, Delegate) est appelée. Cet appel à BeginInvoke(DispatcherPriority, Delegate) accepte deux paramètres : la priorité, qui a la valeur DispatcherPriority.Normal, et le rappel, qui est passé dans une instance du délégué NextPrimeDelegate.

startStopButton.Dispatcher.BeginInvoke(
    DispatcherPriority.Normal,
    new NextPrimeDelegate(CheckNextNumber));

.NET Framework
Disponible depuis 3.0
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: