DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey Class

Definición

Proporciona un identificador de propiedad de dependencia para un acceso de escritura limitado a una propiedad de dependencia de sólo lectura.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
Herencia
DependencyPropertyKeyDependencyPropertyKeyDependencyPropertyKeyDependencyPropertyKey

Ejemplos

En el ejemplo siguiente se registra una propiedad de dependencia de solo lectura y también se usa la clave para dos propósitos en otros miembros de clase: implementar el "contenedor" Get y como el identificador de una operación de determinación protegida que establece el valor en función de los cálculos. de otros valores de propiedad.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

Comentarios

DependencyPropertyKeylas instancias se obtienen como el valor devuelto de una llamada de registro de propiedad RegisterReadOnly de RegisterAttachedReadOnlydependencia mediante los métodos o.DependencyPropertyKey instances are obtained as the return value of a dependency property registration call using the methods RegisterReadOnly or RegisterAttachedReadOnly.

Los tipos que registran una propiedad de dependencia pueden DependencyPropertyKey usar en las SetValue llamadas ClearValue a y que ajustan el valor de la propiedad como parte de la lógica de clase.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. Si lo permite el nivel de acceso de la clave, las clases relacionadas también pueden usar la clave y la propiedad de dependencia.If permitted by the access level of the key, related classes can use the key and the dependency property also. Por ejemplo, puede declarar la clave como interna y otros tipos del mismo ensamblado también pueden establecer esa propiedad de dependencia.For instance, you can declare the key as internal, and other types within the same assembly can also set that dependency property.

El DependencyPropertyKey registro devuelto por la propiedad de dependencia de solo lectura no se debe hacer público, porque la exposición de la clave hace que la propiedad se pueda establecer, con lo que se anula el punto de registro como una propiedad de dependencia de solo lectura.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. Además, la exposición de la clave provoca una falta de coincidencia entre los comportamientos de propiedad Common Language Runtime (CLR)common language runtime (CLR) de dependencia disponibles y sus implementaciones de contenedor de propiedades, que es un diseño de clase incorrecto.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.

En lugar de exponer la propia clave, debe exponer DependencyProperty el valor DependencyPropertyKey de como un public static readonly DependencyProperty en la clase.Instead of exposing the key itself, you should instead expose the DependencyProperty value of the DependencyPropertyKey as a public static readonlyDependencyProperty on your class. Esto permite que la propiedad devuelva un identificador válido de propiedad de dependencia para ciertas operaciones del sistema de propiedades, como la enumeración de valores establecidos localmente.This enables the property to return a valid dependency property identifier for certain property system operations such as enumerating locally set values. Sin embargo, el identificador obtenido no tiene todas las capacidades de un DependencyProperty para muchas operaciones del sistema de propiedades.However, the identifier thus obtained does not have the full capabilities of a DependencyProperty for many property system operations.

Propiedades

DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Obtiene el identificador de propiedad de dependencia asociado a este identificador de propiedad de dependencia de sólo lectura especializado.Gets the dependency property identifier associated with this specialized read-only dependency property identifier.

Métodos

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Invalida los metadatos de una propiedad de dependencia de sólo lectura que está representada por este identificador de propiedad de dependencia.Overrides the metadata of a read-only dependency property that is represented by this dependency property identifier.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: