DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey Class

Definition

Stellt einen Bezeichner für eine Abhängigkeitseigenschaft für den beschränkten Schreibzugriff auf eine schreibgeschützte Abhängigkeitseigenschaft bereit.Provides a dependency property identifier for limited write access to a read-only dependency property.

public ref class DependencyPropertyKey sealed
public sealed class DependencyPropertyKey
type DependencyPropertyKey = class
Public NotInheritable Class DependencyPropertyKey
Vererbung
DependencyPropertyKeyDependencyPropertyKeyDependencyPropertyKeyDependencyPropertyKey

Beispiele

Im folgenden Beispiel wird eine schreibgeschützte Abhängigkeits Eigenschaft registriert, und der Schlüssel wird in anderen Klassenmembern für zwei Zwecke verwendet: Implementieren von Get "Wrapper" und als Bezeichner für eine geschützte Bestimmung, die den Wert auf der Grundlage von Berechnungen festlegt. von anderen Eigenschafts Werten.The following example registers a read-only dependency property, and also uses the key for two purposes in other class members: implementing the get "wrapper", and as the identifier for a protected determination operation that sets the value based on calculations of other property values.

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

DependencyPropertyKey-Instanzen werden als Rückgabewert eines Registrierungs Aufrufs für die Abhängigkeits Eigenschaft RegisterReadOnly mithilfe RegisterAttachedReadOnlyder-Methoden oder abgerufen.DependencyPropertyKey instances are obtained as the return value of a dependency property registration call using the methods RegisterReadOnly or RegisterAttachedReadOnly.

Die Typen, die eine Abhängigkeits Eigenschaft registrieren, DependencyPropertyKey können den in SetValue aufrufen ClearValue von und verwenden, die den Wert der Eigenschaft als Teil der Klassen Logik anpassen.The types that register a dependency property can use the DependencyPropertyKey in calls to SetValue and ClearValue that adjust the property's value as part of class logic. Wenn Sie von der Zugriffsebene des Schlüssels zugelassen werden, können verwandte Klassen auch den Schlüssel und die Abhängigkeits Eigenschaft verwenden.If permitted by the access level of the key, related classes can use the key and the dependency property also. Beispielsweise können Sie den Schlüssel als intern deklarieren, und andere Typen in derselben Assembly können auch diese Abhängigkeits Eigenschaft festlegen.For instance, you can declare the key as internal, and other types within the same assembly can also set that dependency property.

Die DependencyPropertyKey von der schreibgeschützten Abhängigkeits Eigenschafts Registrierung zurückgegebene sollte nicht öffentlich gemacht werden, da durch das verfügbar machen des Schlüssels die Eigenschaft festgelegt werden kann, wodurch der Zeitpunkt der Registrierung als schreibgeschützte Abhängigkeits Eigenschaft besiegt wird.The DependencyPropertyKey returned by read-only dependency property registration should not be made public, because exposing the key makes the property settable, thus defeating the point of registering it as a read-only dependency property. Außerdem verursacht das verfügbar machen des Schlüssels einen Konflikt zwischen dem verfügbaren Verhalten der Abhängigkeits Common Language Runtime (CLR)common language runtime (CLR) Eigenschaft und den zugehörigen Wrapper Implementierungen der Eigenschaften, was ein ungültiges Klassen Design ist.Also, exposing the key causes a mismatch between the available dependency property behaviors and its Common Language Runtime (CLR)common language runtime (CLR) property wrapper implementations, which is bad class design.

Anstatt den Schlüssel DependencyProperty selbst verfügbar DependencyProperty zu machen, sollten Sie stattdessen den Wert DependencyPropertyKey von als public static readonly in der Klasse verfügbar machen.Instead of exposing the key itself, you should instead expose the DependencyProperty value of the DependencyPropertyKey as a public static readonlyDependencyProperty on your class. Dadurch kann die-Eigenschaft einen gültigen Bezeichner für die Abhängigkeits Eigenschaft für bestimmte Eigenschafts System Vorgänge zurückgeben, z. b. das Auflisten von lokal festgelegten WertenThis enables the property to return a valid dependency property identifier for certain property system operations such as enumerating locally set values. Der Bezeichner, der somit abgerufen wurde, verfügt jedoch nicht über die DependencyProperty vollständigen Funktionen von für viele Eigenschaften System Vorgänge.However, the identifier thus obtained does not have the full capabilities of a DependencyProperty for many property system operations.

Eigenschaften

DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Ruft den Bezeichner einer Abhängigkeitseigenschaft ab, der diesem Bezeichner einer spezialisierten schreibgeschützten Abhängigkeitseigenschaft zugeordnet ist.Gets the dependency property identifier associated with this specialized read-only dependency property identifier.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata)

Überschreibt die Metadaten einer schreibgeschützten Abhängigkeitseigenschaft, die durch diesen Bezeichner einer Abhängigkeitseigenschaft dargestellt wird.Overrides the metadata of a read-only dependency property that is represented by this dependency property identifier.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch