DependencyPropertyKey.DependencyProperty Propriété

Définition

Obtient l'identificateur de propriété de dépendance associé à cet identificateur de propriété de dépendance en lecture seule spécialisé.

public:
 property System::Windows::DependencyProperty ^ DependencyProperty { System::Windows::DependencyProperty ^ get(); };
public System.Windows.DependencyProperty DependencyProperty { get; }
member this.DependencyProperty : System.Windows.DependencyProperty
Public ReadOnly Property DependencyProperty As DependencyProperty

Valeur de propriété

DependencyProperty

Identificateur de propriété de dépendance pertinent.

Exemples

L’exemple suivant appelle DependencyProperty pour exposer l’identificateur DependencyProperty (AquariumGraphicProperty) pour la AquariumGraphic propriété de dépendance en lecture seule sur une classe. L’exemple montre également la DependencyPropertyKey création (en tant que membre interne) et l’accesseur get pour AquariumGraphic.

internal static readonly DependencyPropertyKey AquariumSizeKey = DependencyProperty.RegisterReadOnly(
  "AquariumSize",
  typeof(double),
  typeof(Aquarium),
  new PropertyMetadata(double.NaN)
);
public static readonly DependencyProperty AquariumSizeProperty =
  AquariumSizeKey.DependencyProperty;
public double AquariumSize
{
  get { return (double)GetValue(AquariumSizeProperty); }
}
Friend Shared ReadOnly AquariumSizeKey As DependencyPropertyKey = DependencyProperty.RegisterReadOnly("AquariumSize", GetType(Double), GetType(Aquarium), New PropertyMetadata(Double.NaN))
Public Shared ReadOnly AquariumSizeProperty As DependencyProperty = AquariumSizeKey.DependencyProperty
Public ReadOnly Property AquariumSize() As Double
    Get
        Return CDbl(GetValue(AquariumSizeProperty))
    End Get
End Property

Remarques

La DependencyProperty valeur permet à l’identificateur d’une propriété en lecture seule de participer aux opérations courantes du système de propriétés à l’aide de certaines des mêmes interfaces que celles utilisées pour les propriétés de dépendance en lecture-écriture.

Pour implémenter l’accesseur de propriété get pour une propriété de dépendance en lecture seule, vous devez créer et exposer un DependencyProperty identificateur sur votre classe. Cela a deux objectifs :

  • Votre propre classe a besoin de l’identificateur DependencyProperty pour implémenter l’accesseur get pour le wrapper de propriétés. Vous utilisez le DependencyProperty paramètre comme paramètre de l’appel GetValue qui implémente l’accesseur get.

  • DependencyProperty les identificateurs exposent votre propriété de dépendance au système de propriétés de sorte que d’autres méthodes qui s’appuient sur des métadonnées puissent y accéder dans un formulaire standard. Par exemple, si vous avez appelé GetLocalValueEnumerator DependencyObject certains et obtenu une énumération des propriétés définies localement (valeurs et identificateurs) l’identificateur retourné pour une propriété de dépendance en lecture seule serait votre DependencyProperty valeur plutôt que la clé. L’exposition d’un DependencyProperty identificateur n’augmente pas la sécurité de votre propriété de dépendance en lecture seule de quelque manière que ce soit, ce qui rend simplement les opérations qui impliquent votre propriété plus maladroit pour les classes dérivées et les instances de classe ultérieures.

Pour exposer l’identificateur DependencyProperty sur votre classe, vous appelez DependencyProperty directement votre clé. Utilisez cette valeur pour créer un public static readonly DependencyProperty identificateur sur la classe, qui met en parallèle le DependencyPropertyKey.

S’applique à

Voir aussi