DependencyPropertyKey Klasa

Definicja

Udostępnia identyfikator właściwości zależności dla ograniczonego dostępu do zapisu dla właściwości zależności tylko do odczytu.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
Dziedziczenie
DependencyPropertyKey

Przykłady

Poniższy przykład rejestruje właściwość zależności tylko do odczytu, a także używa klucza do dwóch celów w innych składowych klasy: implementowanie otoki "Get" i jako identyfikator chronionej operacji wyznaczania, która ustawia wartość na podstawie obliczeń innych wartości właściwości.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

Uwagi

DependencyPropertyKeywystąpienia są uzyskiwane jako wartość zwracana wywołania rejestracji właściwości zależności przy użyciu metod RegisterReadOnly lub. RegisterAttachedReadOnlyDependencyPropertyKey instances are obtained as the return value of a dependency property registration call using the methods RegisterReadOnly or RegisterAttachedReadOnly.

Typy, które rejestrują właściwość zależności, mogą używać DependencyPropertyKey SetValue wywołań in i ClearValue , które dostosowują wartość właściwości jako część logiki klasy.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. Jeśli jest to dozwolone przez poziom dostępu klucza, klasy pokrewne mogą również używać klucza i właściwości zależności.If permitted by the access level of the key, related classes can use the key and the dependency property also. Na przykład można zadeklarować klucz jako wewnętrzny, a inne typy w tym samym zestawie mogą również ustawić tę właściwość zależności.For instance, you can declare the key as internal, and other types within the same assembly can also set that dependency property.

Wartość DependencyPropertyKey zwrócona przez rejestrację właściwości zależności tylko do odczytu nie powinna być publiczna, ponieważ udostępnienie klucza powoduje, że właściwość settable, w ten sposób obniżając punkt rejestracji jako właściwość zależności tylko do odczytu.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. Ponadto ujawnienie klucza powoduje niezgodność pomiędzy dostępnymi zachowaniami właściwości zależności a jego środowisko uruchomieniowe języka wspólnego (CLR)common language runtime (CLR) implementacjami otoki właściwości, które jest niewłaściwym projektem klasy.Also, exposing the key causes a mismatch between the available dependency property behaviors and its środowisko uruchomieniowe języka wspólnego (CLR)common language runtime (CLR) property wrapper implementations, which is bad class design.

Zamiast ujawniać sam klucz, należy zamiast tego DependencyProperty ujawniać wartość DependencyPropertyKey jako public static readonly DependencyProperty w klasie.Instead of exposing the key itself, you should instead expose the DependencyProperty value of the DependencyPropertyKey as a public static readonlyDependencyProperty on your class. Dzięki temu Właściwość zwraca prawidłowy identyfikator właściwości zależności dla niektórych operacji systemu właściwości, takich jak Wyliczenie lokalnie ustawione wartości.This enables the property to return a valid dependency property identifier for certain property system operations such as enumerating locally set values. Jednak identyfikator uzyskany w ten sposób nie ma pełnych możliwości DependencyProperty dla wielu operacji systemu właściwości.However, the identifier thus obtained does not have the full capabilities of a DependencyProperty for many property system operations.

Właściwości

DependencyProperty

Pobiera identyfikator właściwości zależności skojarzony z tym wyspecjalizowanym identyfikatorem właściwości zależności tylko do odczytu.Gets the dependency property identifier associated with this specialized read-only dependency property identifier.

Metody

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OverrideMetadata(Type, PropertyMetadata)

Przesłania metadane właściwości zależności tylko do odczytu reprezentowanej przez ten identyfikator właściwości zależności.Overrides the metadata of a read-only dependency property that is represented by this dependency property identifier.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy

Zobacz też