DependencyObject Classe

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

Représente un objet qui participe au système de propriétés de dépendance.

public ref class DependencyObject
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DependencyObject
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class DependencyObject
Public Class DependencyObject
Héritage
Object Platform::Object IInspectable DependencyObject
Dérivé
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

Cet exemple définit une classe qui dérive de DependencyObject, et définit une propriété jointe avec le champ d’identificateur. Le scénario de cette classe est qu’il s’agit d’une classe de service qui déclare une propriété jointe que d’autres éléments d’interface utilisateur peuvent définir en XAML Le service agit potentiellement sur les valeurs de propriété jointes sur ces éléments d’interface utilisateur au moment de l’exécution.

public abstract class AquariumServices : DependencyObject
{
    public enum Buoyancy { Floats, Sinks, Drifts }

    public static readonly DependencyProperty BuoyancyProperty = DependencyProperty.RegisterAttached(
      "Buoyancy",
      typeof(Buoyancy),
      typeof(AquariumServices),
      new PropertyMetadata(Buoyancy.Floats)
    );
    public static void SetBuoyancy(DependencyObject element, Buoyancy value)
    {
        element.SetValue(BuoyancyProperty, value);
    }
    public static Buoyancy GetBuoyancy(DependencyObject element)
    {
        return (Buoyancy)element.GetValue(BuoyancyProperty);
    }
}

public static bool ClearSetProperty(DependencyObject targetObject, DependencyProperty targetDP)
{
    if (targetObject == null || targetDP == null)
    {
        throw new ArgumentNullException();
    }
    object localValue = targetObject.ReadLocalValue(targetDP);
    if (localValue == DependencyProperty.UnsetValue)
    {
        return false;
    }
    else
    {
        targetObject.ClearValue(targetDP);
        return true;
    }
}

Cet exemple montre une déclaration de propriété de dépendance simple. Un appel à GetValue constitue l’intégralité de l’implémentation de l’accesseur get pour le wrapper de propriété de la nouvelle propriété de dépendance. Un appel à SetValue constitue l’intégralité de l’implémentation de l’accesseur set . Pour plus d’exemples, consultez les propriétés de dépendance personnalisées.

public class Fish : Control
{
    public static readonly DependencyProperty SpeciesProperty =
    DependencyProperty.Register(
    "Species",
    typeof(String),
    typeof(Fish), null
    );
    public string Species
    {
        get { return (string)GetValue(SpeciesProperty); }
        set { SetValue(SpeciesProperty, (string)value); }
    }
}

Remarques

La DependencyObject classe active les services de système de propriétés de dépendance sur ses nombreuses classes dérivées et est la classe de base immédiate de nombreuses classes importantes liées à l’interface utilisateur, telles que UIElement, Geometry, FrameworkTemplate, Style et ResourceDictionary. Pour plus d’informations sur la prise DependencyObject en charge des propriétés de dépendance, consultez la vue d’ensemble des propriétés de dépendance.

La fonction principale du système de propriétés de dépendance consiste à calculer les valeurs des propriétés et à fournir une notification système sur les valeurs qui ont changé. Une autre classe clé qui participe au système de propriétés de dépendance est DependencyProperty. DependencyProperty active l’inscription des propriétés de dépendance dans le système de propriétés, tandis qu’une DependencyObject classe de base permet aux objets d’utiliser et de définir les propriétés de dépendance.

Voici quelques services et caractéristiques notables que DependencyObject fournit ou prend en charge :

  • Prise en charge de l’hébergement de propriétés de dépendance pour les propriétés de dépendance existantes Windows Runtime.
  • Prise en charge de l’hébergement de propriétés de dépendance personnalisée. Vous inscrivez une propriété de dépendance en appelant la méthode Register et en stockant la valeur de retour de la méthode en tant que propriété statique publique dans votre DependencyObject classe.
  • Prise en charge de l’hébergement de propriétés jointes pour les propriétés jointes existantes Windows Runtime.
  • Prise en charge de l’hébergement de propriétés jointes personnalisées. Vous inscrivez une propriété de dépendance pour l’utilisation de la propriété jointe en appelant la méthode RegisterAttached et en stockant la valeur de retour de la méthode en tant que propriété statique publique dans votre classe.
  • Get et Set méthodes utilitaires pour les valeurs de toutes les propriétés de dépendance qui existent sur un DependencyObject. Vous les utilisez lors de la définition de wrappers de propriétés de dépendance personnalisés et pouvez également les utiliser à partir du code d’application comme alternative à l’utilisation des propriétés wrapper existantes.
  • Utilitaire de scénario avancé pour examiner les métadonnées ou les valeurs de propriété (par exemple GetAnimationBaseValue).
  • Application de l’affinité de thread au thread d’interface utilisateur principal de l’Windows Runtime pour toutes les DependencyObject instances.
  • Propriété DispatcherQueue pour les scénarios avancés de threading. Permet DispatcherQueue à un thread de travail d’exécuter du code qui utilise un thread d’interface DependencyObject utilisateur, car il peut différer l’exécution vers une opération asynchrone qui ne bloque pas ou n’interfère pas avec le thread d’interface utilisateur. Consultez la section «DependencyObject et threading » ci-dessous.
  • Prise en charge de la liaison et du style de données de base, en permettant aux propriétés d’être définies en tant qu’expressions à évaluer ultérieurement dans la durée de vie d’un objet. Ces concepts sont expliqués plus en détail dans la vue d’ensemble des propriétés de dépendance. Voir également la liaison de données en profondeur.

DependencyObject et fil

Toutes les DependencyObject instances doivent être créées sur le thread d’interface utilisateur associé à la fenêtre active d’une application. Cela est appliqué par le système et il existe deux implications importantes pour votre code :

  • Le code qui utilise l’API de deux DependencyObject instances est toujours exécuté sur le même thread, qui est toujours le thread d’interface utilisateur. En règle générale, vous ne rencontrez pas de problèmes de threading dans ce scénario.
  • Le code qui n’est pas en cours d’exécution sur le thread d’interface utilisateur principal ne peut pas accéder DependencyObject directement, car un DependencyObject thread a une affinité de thread uniquement avec le thread d’interface utilisateur. Seul le code qui s’exécute sur le thread d’interface utilisateur peut changer ou même lire la valeur d’une propriété de dépendance. Par exemple, un thread de travail que vous avez lancé avec une tâche .NET ou un thread ThreadPool explicite ne pourra pas lire les propriétés de dépendance ou appeler d'autres API.

Vous n’êtes pas complètement bloqué à l’aide d’un DependencyObject thread de travail. Toutefois, vous devez obtenir un objet DispatcherQueue (la valeur de DependencyObject.DispatcherQueue) DependencyObject afin d’atteindre la séparation délibérée entre le thread d’interface utilisateur de l’application et tous les autres threads exécutés sur le système. La DispatcherQueue méthode TryEnqueue expose l’exécution de votre code attendu. Étant donné qu’il autorise l’accès entre les threads, DependencyObject.DispatcherQueue est la seule API d’instance de DependencyObject ou l’une de ses sous-classes accessibles à partir d’un thread autre que l’interface utilisateur sans lever d’exception entre threads. Toutes les autres DependencyObject API lèvent une exception si vous tentez de les appeler à partir d’un thread de travail ou d’un autre thread autre que l’interface utilisateur.

Les problèmes de thread peuvent généralement être évités dans le code d’interface utilisateur classique. Toutefois, les appareils ne sont généralement pas associés au thread d’interface utilisateur. Si vous utilisez des informations obtenues à partir d’un appareil pour mettre à jour l’interface utilisateur en temps réel, vous devez souvent obtenir une DispatcherQueue information pour pouvoir mettre à jour l’interface utilisateur. Les services sont un autre cas où le code que vous utilisez pour accéder au service peut ne pas s’exécuter sur le thread d’interface utilisateur.

Un scénario de code où vous pouvez rencontrer DependencyObjectdes problèmes liés au threading si vous définissez vos propres DependencyObject types et que vous tentez de les utiliser pour des sources de données ou d’autres scénarios où un DependencyObject n’est pas nécessairement approprié (car l’objet n’est pas directement lié à l’interface utilisateur). Par exemple, vous tentez peut-être d’optimiser les performances avec des threads d’arrière-plan ou d’autres threads de travail qui modifient les valeurs des objets avant la présentation, ou en réponse à un appareil, un service ou une autre entrée externe. Évaluez si vous avez vraiment besoin de propriétés de dépendance pour votre scénario ; peut-être que les propriétés standard sont adéquates.

Classes dérivées DependencyObject

DependencyObject est la classe parente pour plusieurs classes dérivées immédiatement qui sont toutes fondamentales pour le modèle de programmation que vous utilisez pour votre application et son interface utilisateur XAML. Voici quelques-unes des classes dérivées notables :

Constructeurs

Nom Description
DependencyObject()

Fournit un comportement d’initialisation de classe de base pour les classes dérivées DependencyObject .

Propriétés

Nom Description
Dispatcher

Retourne null toujours dans une application du Kit de développement logiciel (SDK) d’application Windows. Utilisez DispatcherQueue à la place.
DispatcherQueue

Obtient le DispatcherQueue résultat auquel cet objet est associé. Représente DispatcherQueue une installation qui peut accéder au DependencyObject thread d’interface utilisateur même si le code est initié par un thread non-interface utilisateur.

Méthodes

Nom Description
ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété de dépendance.
GetAnimationBaseValue(DependencyProperty)

Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active.
GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un DependencyObject.
ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie.
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

Inscrit une fonction de notification pour écouter les modifications apportées à une dependencyProperty spécifique sur cette instance DependencyObject .
SetValue(DependencyProperty, Object)

Définit la valeur locale d’une propriété de dépendance sur un DependencyObject.
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

Annule une notification de modification qui a été précédemment inscrite en appelant RegisterPropertyChangedCallback.

S’applique à

Voir aussi