DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey Class

Определение

Предоставляет идентификатор свойства зависимостей для ограниченного доступа на запись к доступному только для чтения свойству зависимостей.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
Наследование
DependencyPropertyKeyDependencyPropertyKeyDependencyPropertyKeyDependencyPropertyKey

Примеры

В следующем примере регистрируется свойство зависимостей только для чтения, а также используется ключ для двух целей в других членах класса: реализация программы-оболочки Get и идентификатор для операции защищенного определения, которая задает значение на основе вычислений. других значений свойств.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

Комментарии

DependencyPropertyKeyэкземпляры получаются как возвращаемое значение вызова регистрации свойства зависимостей с помощью методов RegisterReadOnly или. RegisterAttachedReadOnlyDependencyPropertyKey instances are obtained as the return value of a dependency property registration call using the methods RegisterReadOnly or RegisterAttachedReadOnly.

Типы, регистрирующие свойство зависимостей, могут использовать DependencyPropertyKey в SetValue вызовах и ClearValue , которые корректируют значение свойства как часть логики класса.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. Если это разрешено уровнем доступа ключа, то связанные классы могут использовать ключ и свойство зависимостей также.If permitted by the access level of the key, related classes can use the key and the dependency property also. Например, можно объявить ключ как внутренний, а другие типы в той же сборке также могут установить это свойство зависимостей.For instance, you can declare the key as internal, and other types within the same assembly can also set that dependency property.

DependencyPropertyKey Регистрация свойства зависимостей, доступного только для чтения, не должна быть сделана открытой, поскольку предоставление ключа делает свойство настраиваемым, тем самым отменяя точку его регистрации как свойство зависимостей только для чтения.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. Кроме того, предоставление ключа вызывает несоответствие между доступными поведениями свойств зависимости и среда CLRcommon language runtime (CLR) реализацией оболочки свойств, что является неправильной конструкцией класса.Also, exposing the key causes a mismatch between the available dependency property behaviors and its среда CLRcommon language runtime (CLR) property wrapper implementations, which is bad class design.

Вместо доступа к самому ключу вместо DependencyProperty него следует предоставить значение в DependencyPropertyKey качестве public static readonly DependencyProperty значения в классе.Instead of exposing the key itself, you should instead expose the DependencyProperty value of the DependencyPropertyKey as a public static readonlyDependencyProperty on your class. Это позволяет свойству возвращать допустимый идентификатор свойства зависимости для определенных операций системы свойств, таких как перечисление локально заданных значений.This enables the property to return a valid dependency property identifier for certain property system operations such as enumerating locally set values. Тем не менее, полученный идентификатор не имеет полных возможностей DependencyProperty для многих операций системы свойств.However, the identifier thus obtained does not have the full capabilities of a DependencyProperty for many property system operations.

Свойства

DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Возвращает идентификатор свойства зависимостей, связанный с данным специализированным идентификатором доступного только для чтения свойства зависимостей.Gets the dependency property identifier associated with this specialized read-only dependency property identifier.

Методы

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

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

Служит хэш-функцией по умолчанию.Serves as the default hash function.

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

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Переопределяет метаданные доступного только для чтения свойства зависимостей, представленного данным идентификатором свойства зависимостей.Overrides the metadata of a read-only dependency property that is represented by this dependency property identifier.

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

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Применяется к

Дополнительно