DependencyObject.Dispatcher Propriété

public:
 property CoreDispatcher ^ Dispatcher { CoreDispatcher ^ get(); };

CoreDispatcher Dispatcher();

public CoreDispatcher Dispatcher { get; }

var coreDispatcher = dependencyObject.dispatcher;

Public ReadOnly Property Dispatcher As CoreDispatcher

Valeur de propriété

CoreDispatcher auquel l’objet DependencyObject est associé, qui représente le thread d’interface utilisateur.

Exemples

Cet exemple montre une utilisation de Dispatcher pour la valeur implicite d’un fichier code-behind pour une page. Cet exemple utilise une expression lambda pour ajouter l’implémentation DispatchedHandler . Le gestionnaire lui-même gère l’événement Accelerometer.ReadingChanged , qui ne sera pas exécuté sur le thread d’interface utilisateur.

private async void ReadingChanged(object sender, AccelerometerReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        AccelerometerReading reading = e.Reading;
        ScenarioOutput_X.Text = String.Format("{0,5:0.00}", reading.AccelerationX);
        ScenarioOutput_Y.Text = String.Format("{0,5:0.00}", reading.AccelerationY);
        ScenarioOutput_Z.Text = String.Format("{0,5:0.00}", reading.AccelerationZ);
    });
}

Remarques

La propriété Dispatcher fournit la référence CoreDispatcher qui peut être utilisée pour marshaler les appels provenant de threads autres que l’interface utilisateur, à l’aide de RunAsync et d’une fonction awaitable. Pour plus d’informations sur les fonctions pouvant être attendues, consultez Appeler des API asynchrones en C# ou Visual Basic. Consultez également la section « DependencyObject and threading » de la rubrique de référence DependencyObject .

Un DependencyObject doit être créé sur un thread d’interface utilisateur et a une affinité avec le thread d’interface utilisateur. Étant donné qu’il s’agit d’un point d’entrée qui permet d’obtenir plusieurs threads, DependencyObject.Dispatcher est la seule api instance de DependencyObject ou de l’une de ses sous-classes accessibles à partir d’un thread autre que l’interface utilisateur sans lever d’exception entre les threads. Toutes les autres API DependencyObject lèvent une exception si vous tentez de les appeler à partir d’un thread worker ou d’un autre thread autre que l’interface utilisateur.

Plus précisément, la propriété Dispatcher obtient le CoreDispatcher associé au thread d’interface utilisateur de l’application. L’exécution du code via la méthode RunAsync de CoreDispatcher est nécessaire si vous envisagez d’interroger ou de modifier la valeur d’une propriété de dépendance, même si cet objet n’est pas encore associé à l’arborescence visuelle XAML ou à l’interface utilisateur visible (racine visuelle de la fenêtre d’application).

Window.Dispatcher fait également référence à un CoreDispatcher associé au thread d’interface utilisateur. Window.Dispatcher n’est fondamentalement qu’un wrapper autour de CoreWindow.Dispatcher afin qu’une classe Window y ait facilement accès.

S’applique à