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

Definizione

Specifica i metadati alternativi per questa proprietà di dipendenza quando è presente nelle istanze di un tipo specificato, rispetto ai metadati specificati nella registrazione della proprietà di dipendenza originale.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.

Overload

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

Specifica i metadati alternativi per questa proprietà di dipendenza quando è presente nelle istanze di un tipo specificato, eseguendo l'override dei metadati esistenti per la proprietà di dipendenza quando è stata ereditata dai tipi di 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)

Specifica i metadati alternativi per una proprietà di dipendenza di sola lettura quando è presente nelle istanze di un tipo specificato, in sostituzione dei metadati specificati nella registrazione della proprietà di dipendenza iniziale.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. È necessario passare DependencyPropertyKey per la proprietà di dipendenza di sola lettura per evitare la generazione di un'eccezione.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)

Specifica i metadati alternativi per questa proprietà di dipendenza quando è presente nelle istanze di un tipo specificato, eseguendo l'override dei metadati esistenti per la proprietà di dipendenza quando è stata ereditata dai tipi di 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)

Parametri

forType
Type Type Type Type

Tipo in cui questa proprietà di dipendenza viene ereditata e in cui verranno applicati i metadati alternativi.The type where this dependency property is inherited and where the provided alternate metadata will be applied.

typeMetadata
PropertyMetadata PropertyMetadata PropertyMetadata PropertyMetadata

Metadati da applicare alla proprietà di dipendenza nel tipo che esegue l'override.The metadata to apply to the dependency property on the overriding type.

Eccezioni

Si è tentato di eseguire l'override dei metadati in una proprietà di dipendenza di sola lettura. Tale operazione non può essere eseguita usando questa firma.An attempt was made to override metadata on a read-only dependency property (that operation cannot be done using this signature).

I metadati sono già stati stabiliti per la proprietà di dipendenza nello stato attuale per il tipo specificato.Metadata was already established for the dependency property as it exists on the provided type.

Commenti

I metadati della proprietà di dipendenza devono essere sottoposti a override prima che il sistema di proprietà usi la proprietà di dipendenza.Dependency property metadata should be overridden before the property system uses the dependency property. Ciò equivale al momento in cui vengono create istanze specifiche utilizzando la classe che registra la proprietà di dipendenza.This equates to the time that specific instances are created using the class that registers the dependency property. Le chiamate OverrideMetadata a devono essere eseguite solo nei costruttori statici del tipo che fornisce se stesso forType come parametro di questo metodo o mediante un'istanza simile.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. Il tentativo di modificare i metadati dopo l'esistenza di istanze del tipo di proprietario non genererà eccezioni, ma comporterà comportamenti incoerenti nel sistema di proprietà.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.

Dopo aver stabilito i metadati per un particolare override della classe derivata con questo metodo, i tentativi successivi di eseguire l'override dei metadati nella stessa classe derivata genereranno un'eccezione.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.

I metadati forniti vengono uniti con i metadati della proprietà per la proprietà di dipendenza esistente nel proprietario di base.The supplied metadata is merged with the property metadata for the dependency property as it exists on the base owner. Tutte le caratteristiche specificate nei metadati di base originali vengono mantenute. solo le caratteristiche modificate in modo specifico nei nuovi metadati sostituiranno le caratteristiche dei metadati di 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. Alcune caratteristiche, ad DefaultValue esempio, vengono sostituite se specificate nei nuovi metadati.Some characteristics such as DefaultValue are replaced if specified in the new metadata. Altri, ad esempio PropertyChangedCallback, vengono combinati.Others, such as PropertyChangedCallback, are combined. Infine, il comportamento di Unione dipende dal tipo di metadati della proprietà usato per l'override, quindi il comportamento descritto di seguito riguarda le classi di metadati della proprietà esistenti usate WPFWPF dalle proprietà di dipendenza.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. Per informazioni dettagliate, vedere metadati delle proprietà di dipendenza e metadati delle proprietà del Framework.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)

Specifica i metadati alternativi per una proprietà di dipendenza di sola lettura quando è presente nelle istanze di un tipo specificato, in sostituzione dei metadati specificati nella registrazione della proprietà di dipendenza iniziale.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. È necessario passare DependencyPropertyKey per la proprietà di dipendenza di sola lettura per evitare la generazione di un'eccezione.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)

Parametri

forType
Type Type Type Type

Tipo in cui questa proprietà di dipendenza viene ereditata e in cui verranno applicati i metadati alternativi.The type where this dependency property is inherited and where the provided alternate metadata will be applied.

typeMetadata
PropertyMetadata PropertyMetadata PropertyMetadata PropertyMetadata

Metadati da applicare alla proprietà di dipendenza nel tipo che esegue l'override.The metadata to apply to the dependency property on the overriding type.

key
DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey

Chiave di accesso per una proprietà di dipendenza di sola lettura.The access key for a read-only dependency property.

Commenti

Questa firma fornisce l'implementazione sottostante per un metodo identificatore della proprietà di dipendenzaDependencyPropertyKeydi sola lettura ().This signature provides underlying implementation for a read-only dependency property identifier (DependencyPropertyKey) method. Se si esegue l'override dei metadati per una proprietà di dipendenza di OverrideMetadata(Type, PropertyMetadata)lettura/scrittura, usare.If overriding metadata for a read-write dependency property, use OverrideMetadata(Type, PropertyMetadata).

I metadati della proprietà di dipendenza devono essere sottoposti a override prima che il sistema di proprietà usi la proprietà di dipendenza.Dependency property metadata should be overridden before the property system uses the dependency property. Ciò equivale al momento in cui vengono creati oggetti specifici per la classe che registra la proprietà di dipendenza.This equates to the time that specific objects are created for the class that registers the dependency property. Le chiamate OverrideMetadata a devono essere eseguite solo nei costruttori statici del tipo che fornisce se stesso forType come parametro di questo metodo o mediante un'istanza simile.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. Il tentativo di modificare i metadati dopo l'esistenza di istanze del tipo di proprietario non genererà eccezioni, ma comporterà comportamenti incoerenti nel sistema di proprietà.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.

Dopo aver stabilito i metadati per un particolare override della classe derivata con questo metodo, i tentativi successivi di eseguire l'override dei metadati nella stessa classe derivata genereranno un'eccezione.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.

I metadati forniti vengono uniti con i metadati della proprietà per la proprietà di dipendenza esistente nel proprietario di base.The supplied metadata is merged with the property metadata for the dependency property as it exists on the base owner. Tutte le caratteristiche specificate nei metadati di base originali vengono mantenute. solo le caratteristiche modificate in modo specifico nei nuovi metadati sostituiranno le caratteristiche dei metadati di 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. Alcune caratteristiche, ad DefaultValue esempio, vengono sostituite se specificate nei nuovi metadati.Some characteristics such as DefaultValue are replaced if specified in the new metadata. Altri, ad esempio PropertyChangedCallback, vengono combinati.Others, such as PropertyChangedCallback, are combined. Il comportamento di Unione dipende dal tipo di metadati della proprietà usato per la sostituzione.The merge behavior depends on the property metadata type being used for the override. Per informazioni dettagliate, vedere metadati delle proprietà di dipendenza e metadati delle proprietà del Framework.For details, see Dependency Property Metadata and Framework Property Metadata.

Si applica a