DependencyPropertyKey.DependencyProperty Eigenschaft

Definition

Ruft den Abhängigkeitseigenschaftsbezeichner ab, der diesem speziellen schreibgeschützten Abhängigkeitseigenschaftsbezeichner zugeordnet ist.

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

Eigenschaftswert

Der relevante Bezeichner der Abhängigkeitseigenschaft.

Beispiele

Im folgenden Beispiel wird DependencyProperty aufgerufen, um den DependencyProperty-Bezeichner (AquariumGraphicProperty) für die AquariumGraphic schreibgeschützte Abhängigkeitseigenschaft einer Klasse verfügbar zu machen. Das Beispiel zeigt auch die DependencyPropertyKey Erstellung (als internes Mitglied) und den Get Accessor für 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

Hinweise

Mit dem wert DependencyProperty kann der Bezeichner einer schreibgeschützten Eigenschaft an allgemeinen Eigenschaftensystemvorgängen teilnehmen, wobei einige der gleichen Schnittstellen verwendet werden, wie sie für Abhängigkeitseigenschaften mit Lese-/Schreibzugriff verwendet werden.

Um den Get-Eigenschaftsaccessor für eine schreibgeschützte Abhängigkeitseigenschaft zu implementieren, sollten Sie einen DependencyProperty Bezeichner für Ihre Klasse erstellen und verfügbar machen. Dies dient zwei Zwecken:

  • Ihre eigene Klasse benötigt den DependencyProperty Bezeichner, um den Get-Accessor für den Eigenschaftenwrapper zu implementieren. Sie verwenden die DependencyProperty als Parameter für den GetValue Aufruf, der den Get-Accessor implementiert.

  • DependencyProperty Bezeichner machen Ihre Abhängigkeitseigenschaft für das Eigenschaftensystem verfügbar, sodass andere Methoden, die auf Metadaten basieren, in einem Standardformular darauf zugreifen können. Wenn Sie z. B. GetLocalValueEnumerator für einige DependencyObject aufgerufen und eine Aufzählung von lokal festgelegten Eigenschaften (Werten und Bezeichnern) abgerufen haben, ist der für eine schreibgeschützte Abhängigkeitseigenschaft zurückgegebene Bezeichner Ihr DependencyProperty Wert anstelle des Schlüssels. Wenn Sie keinen DependencyProperty Bezeichner verfügbar machen, erhöht die Sicherheit Ihrer schreibgeschützten Abhängigkeitseigenschaft auf irgendeine Weise nicht, und es werden nur Vorgänge ausgeführt, die Ihre Eigenschaft sowohl für nachfolgende abgeleitete Klassen als auch für Klasseninstanzen ungünstiger einbeziehen.

Um den DependencyProperty-Bezeichner für Ihre Klasse verfügbar zu machen, rufen Sie DependencyProperty direkt auf Ihrem Schlüssel auf. Verwenden Sie diesen Wert, um einen public static readonlyDependencyProperty Bezeichner für die Klasse zu erstellen, die die DependencyPropertyKeyparallel darstellt.

Gilt für:

Weitere Informationen