DependencyProperty.OverrideMetadata DependencyProperty.OverrideMetadata DependencyProperty.OverrideMetadata DependencyProperty.OverrideMetadata Method

Definición

Proporciona los metadatos alternativos para esta propiedad de dependencia cuando se encuentra en instancias de un tipo especificado, frente a los metadatos que se proporcionaron en el registro inicial de la propiedad de dependencia.Supplies alternate metadata for this dependency property when it is present on instances of a specified type, versus the metadata that was provided in the initial dependency property registration.

Sobrecargas

OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata)

Especifica los metadatos alternativos para esta propiedad de dependencia cuando se encuentra en instancias de un tipo especificado y reemplaza los metadatos existentes para la propiedad de dependencia tal y como se heredó de los tipos base.Specifies alternate metadata for this dependency property when it is present on instances of a specified type, overriding the metadata that existed for the dependency property as it was inherited from base types.

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

Proporciona los metadatos alternativos para una propiedad de dependencia de solo lectura cuando se encuentra en instancias de un tipo especificado y reemplaza los metadatos que se proporcionaron en el registro inicial de la propiedad de dependencia.Supplies alternate metadata for a read-only dependency property when it is present on instances of a specified type, overriding the metadata that was provided in the initial dependency property registration. Debe pasar la DependencyPropertyKey para la propiedad de dependencia de solo lectura evitar que se genere una excepción.You must pass the DependencyPropertyKey for the read-only dependency property to avoid raising an exception.

OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata)

Especifica los metadatos alternativos para esta propiedad de dependencia cuando se encuentra en instancias de un tipo especificado y reemplaza los metadatos existentes para la propiedad de dependencia tal y como se heredó de los tipos base.Specifies alternate metadata for this dependency property when it is present on instances of a specified type, overriding the metadata that existed for the dependency property as it was inherited from base types.

public:
 void OverrideMetadata(Type ^ forType, System::Windows::PropertyMetadata ^ typeMetadata);
public void OverrideMetadata (Type forType, System.Windows.PropertyMetadata typeMetadata);
member this.OverrideMetadata : Type * System.Windows.PropertyMetadata -> unit
Public Sub OverrideMetadata (forType As Type, typeMetadata As PropertyMetadata)

Parámetros

forType
Type Type Type Type

Tipo en el que se hereda esta propiedad de dependencia y donde se aplicarán los metadatos alternativos proporcionados.The type where this dependency property is inherited and where the provided alternate metadata will be applied.

typeMetadata
PropertyMetadata PropertyMetadata PropertyMetadata PropertyMetadata

Metadatos que se deben aplicar a la propiedad de dependencia en el tipo de reemplazo.The metadata to apply to the dependency property on the overriding type.

Excepciones

Se intentaron reemplazar los metadatos en una propiedad de dependencia de solo lectura (esa operación no se puede realizar con esta signatura).An attempt was made to override metadata on a read-only dependency property (that operation cannot be done using this signature).

Los metadatos ya se establecieron para la propiedad de dependencia tal como existe en el tipo proporcionado.Metadata was already established for the dependency property as it exists on the provided type.

Comentarios

Los metadatos de la propiedad de dependencia deben invalidarse antes de que el sistema de propiedades use la propiedad de dependencia.Dependency property metadata should be overridden before the property system uses the dependency property. Esto equivale al momento en que se crean instancias específicas mediante la clase que registra la propiedad de dependencia.This equates to the time that specific instances are created using the class that registers the dependency property. Las llamadas OverrideMetadata a solo deben realizarse dentro de los constructores estáticos del tipo que se proporciona forType a sí mismo como parámetro de este método, o a través de una creación de instancias similar.Calls to OverrideMetadata should only be performed within the static constructors of the type that provides itself as the forType parameter of this method, or through similar instantiation. Si intenta cambiar los metadatos después de que existan instancias del tipo de propietario, no se producirán excepciones, pero se producirán comportamientos incoherentes en el sistema de propiedades.Attempting to change metadata after instances of the owner type exist will not raise exceptions, but will result in inconsistent behaviors in the property system.

Después de establecer los metadatos para una invalidación de una clase derivada determinada con este método, los intentos posteriores de invalidar los metadatos en esta misma clase derivada producirán una excepción.After metadata for a particular derived class override is established with this method, subsequent attempts to override metadata on this same derived class will raise an exception.

Los metadatos proporcionados se combinan con los metadatos de propiedad de la propiedad de dependencia tal como existe en el propietario base.The supplied metadata is merged with the property metadata for the dependency property as it exists on the base owner. Todas las características que se especificaron en los metadatos de base originales se conservarán; solo las características que se cambiaron específicamente en los nuevos metadatos invalidarán las características de los metadatos base.Any characteristics that were specified in the original base metadata will persist; only those characteristics that were specifically changed in the new metadata will override the characteristics of the base metadata. Algunas características como DefaultValue se reemplazan si se especifican en los nuevos metadatos.Some characteristics such as DefaultValue are replaced if specified in the new metadata. Otros, como PropertyChangedCallback, se combinan.Others, such as PropertyChangedCallback, are combined. En última instancia, el comportamiento de fusión mediante combinación depende del tipo de metadatos de propiedad que se usa para la invalidación, por lo que el comportamiento que WPFWPF se describe aquí es para las clases de metadatos de propiedades existentes usadas por las propiedades de dependencia.Ultimately, the merge behavior depends on the property metadata type being used for the override, so the behavior described here is for the existing property metadata classes used by WPFWPF dependency properties. Para obtener más información, consulte metadatos de propiedad de dependencia y metadatos de propiedad de marco.For details, see Dependency Property Metadata and Framework Property Metadata.

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

Proporciona los metadatos alternativos para una propiedad de dependencia de solo lectura cuando se encuentra en instancias de un tipo especificado y reemplaza los metadatos que se proporcionaron en el registro inicial de la propiedad de dependencia.Supplies alternate metadata for a read-only dependency property when it is present on instances of a specified type, overriding the metadata that was provided in the initial dependency property registration. Debe pasar la DependencyPropertyKey para la propiedad de dependencia de solo lectura evitar que se genere una excepción.You must pass the DependencyPropertyKey for the read-only dependency property to avoid raising an exception.

public:
 void OverrideMetadata(Type ^ forType, System::Windows::PropertyMetadata ^ typeMetadata, System::Windows::DependencyPropertyKey ^ key);
public void OverrideMetadata (Type forType, System.Windows.PropertyMetadata typeMetadata, System.Windows.DependencyPropertyKey key);
member this.OverrideMetadata : Type * System.Windows.PropertyMetadata * System.Windows.DependencyPropertyKey -> unit
Public Sub OverrideMetadata (forType As Type, typeMetadata As PropertyMetadata, key As DependencyPropertyKey)

Parámetros

forType
Type Type Type Type

Tipo en el que se hereda esta propiedad de dependencia y donde se aplicarán los metadatos alternativos proporcionados.The type where this dependency property is inherited and where the provided alternate metadata will be applied.

typeMetadata
PropertyMetadata PropertyMetadata PropertyMetadata PropertyMetadata

Metadatos que se deben aplicar a la propiedad de dependencia en el tipo de reemplazo.The metadata to apply to the dependency property on the overriding type.

key
DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey

Clave de acceso para una propiedad de dependencia de solo lectura.The access key for a read-only dependency property.

Comentarios

Esta firma proporciona una implementación subyacente para un método identificador de propiedad de dependencia deDependencyPropertyKeysolo lectura ().This signature provides underlying implementation for a read-only dependency property identifier (DependencyPropertyKey) method. Si se reemplazan los metadatos de una propiedad de dependencia de OverrideMetadata(Type, PropertyMetadata)lectura y escritura, use.If overriding metadata for a read-write dependency property, use OverrideMetadata(Type, PropertyMetadata).

Los metadatos de la propiedad de dependencia deben invalidarse antes de que el sistema de propiedades use la propiedad de dependencia.Dependency property metadata should be overridden before the property system uses the dependency property. Esto equivale al tiempo que se crean objetos específicos para la clase que registra la propiedad de dependencia.This equates to the time that specific objects are created for the class that registers the dependency property. Las llamadas OverrideMetadata a solo deben realizarse dentro de los constructores estáticos del tipo que se proporciona forType a sí mismo como parámetro de este método, o a través de una creación de instancias similar.Calls to OverrideMetadata should only be performed within the static constructors of the type that provides itself as the forType parameter of this method, or through similar instantiation. Si intenta cambiar los metadatos después de que existan instancias del tipo de propietario, no se producirán excepciones, pero se producirán comportamientos incoherentes en el sistema de propiedades.Attempting to change metadata after instances of the owner type exist will not raise exceptions, but will result in inconsistent behaviors in the property system.

Después de establecer los metadatos para una invalidación de una clase derivada determinada con este método, los intentos posteriores de invalidar los metadatos en esta misma clase derivada producirán una excepción.After metadata for a particular derived class override is established with this method, subsequent attempts to override metadata on this same derived class will raise an exception.

Los metadatos proporcionados se combinan con los metadatos de propiedad de la propiedad de dependencia tal como existe en el propietario base.The supplied metadata is merged with the property metadata for the dependency property as it exists on the base owner. Todas las características que se especificaron en los metadatos de base originales se conservarán; solo las características que se cambiaron específicamente en los nuevos metadatos invalidarán las características de los metadatos base.Any characteristics that were specified in the original base metadata will persist; only those characteristics that were specifically changed in the new metadata will override the characteristics of the base metadata. Algunas características como DefaultValue se reemplazan si se especifican en los nuevos metadatos.Some characteristics such as DefaultValue are replaced if specified in the new metadata. Otros, como PropertyChangedCallback, se combinan.Others, such as PropertyChangedCallback, are combined. El comportamiento de la combinación depende del tipo de metadatos de la propiedad que se usa para la invalidación.The merge behavior depends on the property metadata type being used for the override. Para obtener más información, consulte metadatos de propiedad de dependencia y metadatos de propiedad de marco.For details, see Dependency Property Metadata and Framework Property Metadata.

Se aplica a