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

Définition

Fournit des métadonnées de remplacement pour cette propriété de dépendance quand elle est présente sur des instances d’un type spécifié, différentes des métadonnées qui ont été fournies dans l’inscription de la propriété de dépendance initiale.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.

Surcharges

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

Spécifie les métadonnées de remplacement pour cette propriété de dépendance quand elle est présente sur des instances d’un type spécifié, substituant les métadonnées qui existaient pour la propriété de dépendance quand elle a été héritée de types de 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)

Fournit des métadonnées de remplacement pour une propriété de dépendance en lecture seule quand elle est présente sur des instances d’un type spécifié, substituant les métadonnées fournies dans l’inscription de la propriété de dépendance initiale.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. Vous devez passer DependencyPropertyKey pour la propriété de dépendance en lecture seule pour éviter de lever une exception.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)

Spécifie les métadonnées de remplacement pour cette propriété de dépendance quand elle est présente sur des instances d’un type spécifié, substituant les métadonnées qui existaient pour la propriété de dépendance quand elle a été héritée de types de 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)

Paramètres

forType
Type Type Type Type

Type où cette propriété de dépendance est héritée et emplacement où les métadonnées de remplacement fournies sont appliquées.The type where this dependency property is inherited and where the provided alternate metadata will be applied.

typeMetadata
PropertyMetadata PropertyMetadata PropertyMetadata PropertyMetadata

Métadonnées à appliquer à la propriété de dépendance sur le type de substitution.The metadata to apply to the dependency property on the overriding type.

Exceptions

Vous avez essayé de substituer des métadonnées sur une propriété de dépendance en lecture seule (vous ne pouvez pas effectuer cette opération à l’aide de cette signature).An attempt was made to override metadata on a read-only dependency property (that operation cannot be done using this signature).

Des métadonnées ont déjà été établies pour la propriété de dépendance telle qu’elle existe sur le type fourni.Metadata was already established for the dependency property as it exists on the provided type.

Remarques

Les métadonnées de propriété de dépendance doivent être remplacées avant que le système de propriétés utilise la propriété de dépendance.Dependency property metadata should be overridden before the property system uses the dependency property. Cela équivaut à l’heure à laquelle des instances spécifiques sont créées à l’aide de la classe qui inscrit la propriété de dépendance.This equates to the time that specific instances are created using the class that registers the dependency property. Les appels OverrideMetadata à doivent uniquement être effectués dans les constructeurs statiques du type qui se fournit lui- forType même en tant que paramètre de cette méthode, ou par le biais d’une instanciation similaire.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. La tentative de modification des métadonnées après l’existence d’instances du type de propriétaire ne lève pas d’exception, mais entraîne des comportements incohérents dans le système de propriétés.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.

Une fois que les métadonnées d’une substitution de classe dérivée particulière sont établies avec cette méthode, les tentatives suivantes de substitution des métadonnées sur cette même classe dérivée lèvent une exception.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.

Les métadonnées fournies sont fusionnées avec les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le propriétaire de base.The supplied metadata is merged with the property metadata for the dependency property as it exists on the base owner. Toutes les caractéristiques spécifiées dans les métadonnées de base d’origine sont conservées; seules les caractéristiques qui ont été spécifiquement modifiées dans les nouvelles métadonnées remplaceront les caractéristiques des métadonnées de 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. Certaines caractéristiques, telles DefaultValue que, sont remplacées si elles sont spécifiées dans les nouvelles métadonnées.Some characteristics such as DefaultValue are replaced if specified in the new metadata. D’autres, tels PropertyChangedCallbackque, sont combinés.Others, such as PropertyChangedCallback, are combined. Au final, le comportement de fusion dépend du type de métadonnées de propriété utilisé pour la substitution, donc le comportement décrit ici concerne les classes de métadonnées de WPFWPF propriété existantes utilisées par les propriétés de dépendance.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. Pour plus d’informations, consultez métadonnées de propriété de dépendance et métadonnées de propriété d’infrastructure.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)

Fournit des métadonnées de remplacement pour une propriété de dépendance en lecture seule quand elle est présente sur des instances d’un type spécifié, substituant les métadonnées fournies dans l’inscription de la propriété de dépendance initiale.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. Vous devez passer DependencyPropertyKey pour la propriété de dépendance en lecture seule pour éviter de lever une exception.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)

Paramètres

forType
Type Type Type Type

Type où cette propriété de dépendance est héritée et emplacement où les métadonnées de remplacement fournies sont appliquées.The type where this dependency property is inherited and where the provided alternate metadata will be applied.

typeMetadata
PropertyMetadata PropertyMetadata PropertyMetadata PropertyMetadata

Métadonnées à appliquer à la propriété de dépendance sur le type de substitution.The metadata to apply to the dependency property on the overriding type.

key
DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey

Clé d’accès pour une propriété de dépendance en lecture seule.The access key for a read-only dependency property.

Remarques

Cette signature fournit une implémentation sous-jacente pour une méthode d’identificateur de propriétéDependencyPropertyKeyde dépendance en lecture seule ().This signature provides underlying implementation for a read-only dependency property identifier (DependencyPropertyKey) method. Si vous substituez des métadonnées pour une propriété de dépendance en OverrideMetadata(Type, PropertyMetadata)lecture-écriture, utilisez.If overriding metadata for a read-write dependency property, use OverrideMetadata(Type, PropertyMetadata).

Les métadonnées de propriété de dépendance doivent être remplacées avant que le système de propriétés utilise la propriété de dépendance.Dependency property metadata should be overridden before the property system uses the dependency property. Cela équivaut à l’heure à laquelle des objets spécifiques sont créés pour la classe qui inscrit la propriété de dépendance.This equates to the time that specific objects are created for the class that registers the dependency property. Les appels OverrideMetadata à doivent uniquement être effectués dans les constructeurs statiques du type qui se fournit lui- forType même en tant que paramètre de cette méthode, ou par le biais d’une instanciation similaire.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. La tentative de modification des métadonnées après l’existence d’instances du type de propriétaire ne lève pas d’exception, mais entraîne des comportements incohérents dans le système de propriétés.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.

Une fois que les métadonnées d’une substitution de classe dérivée particulière sont établies avec cette méthode, les tentatives suivantes de substitution des métadonnées sur cette même classe dérivée lèvent une exception.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.

Les métadonnées fournies sont fusionnées avec les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le propriétaire de base.The supplied metadata is merged with the property metadata for the dependency property as it exists on the base owner. Toutes les caractéristiques spécifiées dans les métadonnées de base d’origine sont conservées; seules les caractéristiques qui ont été spécifiquement modifiées dans les nouvelles métadonnées remplaceront les caractéristiques des métadonnées de 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. Certaines caractéristiques, telles DefaultValue que, sont remplacées si elles sont spécifiées dans les nouvelles métadonnées.Some characteristics such as DefaultValue are replaced if specified in the new metadata. D’autres, tels PropertyChangedCallbackque, sont combinés.Others, such as PropertyChangedCallback, are combined. Le comportement de fusion dépend du type de métadonnées de propriété utilisé pour le remplacement.The merge behavior depends on the property metadata type being used for the override. Pour plus d’informations, consultez métadonnées de propriété de dépendance et métadonnées de propriété d’infrastructure.For details, see Dependency Property Metadata and Framework Property Metadata.

S’applique à