DependencyProperty.OverrideMetadata Methode

Definition

Stellt alternative Metadaten für diese Abhängigkeitseigenschaft bereit, wenn sie in Instanzen eines angegebenen Typs vorhanden ist, im Gegensatz zu den Metadaten, die bei der ersten Registrierung der Abhängigkeitseigenschaft bereitgestellt wurden.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.

Überlädt

OverrideMetadata(Type, PropertyMetadata)

Gibt alternative Metadaten für diese Abhängigkeitseigenschaft an, wenn sie in Instanzen eines angegebenen Typs vorhanden ist. Dabei werden die Metadaten überschrieben, die für die Abhängigkeitseigenschaft bei der Vererbung von Basistypen vorhanden waren.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)

Stellt alternative Metadaten für eine schreibgeschützte Abhängigkeitseigenschaft bereit, wenn sie in Instanzen eines angegebenen Typs vorhanden ist, wodurch die Metadaten überschrieben werden, die bei der ersten Registrierung der Abhängigkeitseigenschaft bereitgestellt wurden.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. Sie müssen die DependencyPropertyKey für die schreibgeschützte Abhängigkeitseigenschaft übergeben, um das Auslösen einer Ausnahme zu vermeiden.You must pass the DependencyPropertyKey for the read-only dependency property to avoid raising an exception.

OverrideMetadata(Type, PropertyMetadata)

Gibt alternative Metadaten für diese Abhängigkeitseigenschaft an, wenn sie in Instanzen eines angegebenen Typs vorhanden ist. Dabei werden die Metadaten überschrieben, die für die Abhängigkeitseigenschaft bei der Vererbung von Basistypen vorhanden waren.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)

Parameter

forType
Type

Der Typ, bei dem diese Abhängigkeitseigenschaft geerbt wird und bei dem die bereitgestellten alternativen Metadaten angewendet werden.The type where this dependency property is inherited and where the provided alternate metadata will be applied.

typeMetadata
PropertyMetadata

Die Metadaten, die auf die Abhängigkeitseigenschaft im überschreibenden Typ angewendet werden sollen.The metadata to apply to the dependency property on the overriding type.

Ausnahmen

Es wurde versucht, die Metadaten für eine schreibgeschützte Abhängigkeitseigenschaft zu überschreiben (dieser Vorgang kann nicht mit dieser Signatur ausgeführt werden).An attempt was made to override metadata on a read-only dependency property (that operation cannot be done using this signature).

Metadaten wurden für die Abhängigkeitseigenschaft bereits festgelegt, wie im bereitgestellten Typ vorhanden.Metadata was already established for the dependency property as it exists on the provided type.

Hinweise

Metadaten für Abhängigkeits Eigenschaften sollten überschrieben werden, bevor das Eigenschaften System die Abhängigkeits Eigenschaft verwendet.Dependency property metadata should be overridden before the property system uses the dependency property. Dies entspricht der Zeit, in der bestimmte Instanzen mithilfe der Klasse erstellt werden, die die Abhängigkeits Eigenschaft registriert.This equates to the time that specific instances are created using the class that registers the dependency property. Aufrufe von OverrideMetadata sollten nur innerhalb der statischen Konstruktoren des Typs ausgeführt werden, der sich selbst als forType Parameter dieser Methode oder über eine ähnliche Instanziierung bereitstellt.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. Wenn Sie versuchen, die Metadaten zu ändern, nachdem Instanzen des Besitzertyps vorhanden sind, werden keine Ausnahmen ausgelöst, dies führt jedoch zu inkonsistenten Verhalten im Eigenschaften System.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.

Nachdem die Metadaten für eine bestimmte abgeleitete Klasse mit dieser Methode überschrieben wurden, wird bei nachfolgenden versuchen, Metadaten für diese abgeleitete Klasse zu überschreiben, eine Ausnahme ausgelöst.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.

Die angegebenen Metadaten werden mit den Eigenschafts Metadaten für die Abhängigkeits Eigenschaft zusammengeführt, so wie Sie auf dem Basis Besitzer vorhanden sind.The supplied metadata is merged with the property metadata for the dependency property as it exists on the base owner. Alle Eigenschaften, die in den ursprünglichen Basis Metadaten angegeben wurden, bleiben erhalten. nur die Merkmale, die speziell in den neuen Metadaten geändert wurden, überschreiben die Eigenschaften der Basis Metadaten.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. Einige Merkmale wie DefaultValue werden ersetzt, wenn Sie in den neuen Metadaten angegeben werden.Some characteristics such as DefaultValue are replaced if specified in the new metadata. Andere, wie z. b. PropertyChangedCallback, werden kombiniert.Others, such as PropertyChangedCallback, are combined. Letztendlich hängt das Zusammensetzungs Verhalten vom Eigenschaftentyp ab, der für die Überschreibung verwendet wird, sodass das hier beschriebene Verhalten für die vorhandenen eigenschaftenmetadatenklassen ist, die von WPFWPF Abhängigkeits Eigenschaften verwendet werden.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. Weitere Informationen finden Sie unter Metadaten für Abhängigkeits Eigenschaften und Framework-Eigenschaften Metadaten.For details, see Dependency Property Metadata and Framework Property Metadata.

OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey)

Stellt alternative Metadaten für eine schreibgeschützte Abhängigkeitseigenschaft bereit, wenn sie in Instanzen eines angegebenen Typs vorhanden ist, wodurch die Metadaten überschrieben werden, die bei der ersten Registrierung der Abhängigkeitseigenschaft bereitgestellt wurden.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. Sie müssen die DependencyPropertyKey für die schreibgeschützte Abhängigkeitseigenschaft übergeben, um das Auslösen einer Ausnahme zu vermeiden.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)

Parameter

forType
Type

Der Typ, bei dem diese Abhängigkeitseigenschaft geerbt wird und bei dem die bereitgestellten alternativen Metadaten angewendet werden.The type where this dependency property is inherited and where the provided alternate metadata will be applied.

typeMetadata
PropertyMetadata

Die Metadaten, die auf die Abhängigkeitseigenschaft im überschreibenden Typ angewendet werden sollen.The metadata to apply to the dependency property on the overriding type.

key
DependencyPropertyKey

Der Zugriffsschlüssel für eine schreibgeschützte Abhängigkeitseigenschaft.The access key for a read-only dependency property.

Hinweise

Diese Signatur stellt die zugrunde liegende Implementierung für eine schreibgeschützte Abhängigkeits Eigenschaften-bezeichnermethode (DependencyPropertyKey) bereit.This signature provides underlying implementation for a read-only dependency property identifier (DependencyPropertyKey) method. Verwenden Sie zum Überschreiben von Metadaten für eine Abhängigkeits Eigenschaft mit Lese-/Schreibzugriff OverrideMetadata(Type, PropertyMetadata)If overriding metadata for a read-write dependency property, use OverrideMetadata(Type, PropertyMetadata).

Metadaten für Abhängigkeits Eigenschaften sollten überschrieben werden, bevor das Eigenschaften System die Abhängigkeits Eigenschaft verwendet.Dependency property metadata should be overridden before the property system uses the dependency property. Dies entspricht der Zeit, in der bestimmte Objekte für die Klasse erstellt werden, die die Abhängigkeits Eigenschaft registriert.This equates to the time that specific objects are created for the class that registers the dependency property. Aufrufe von OverrideMetadata sollten nur innerhalb der statischen Konstruktoren des Typs ausgeführt werden, der sich selbst als forType Parameter dieser Methode oder über eine ähnliche Instanziierung bereitstellt.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. Wenn Sie versuchen, die Metadaten zu ändern, nachdem Instanzen des Besitzertyps vorhanden sind, werden keine Ausnahmen ausgelöst, dies führt jedoch zu inkonsistenten Verhalten im Eigenschaften System.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.

Nachdem die Metadaten für eine bestimmte abgeleitete Klasse mit dieser Methode überschrieben wurden, wird bei nachfolgenden versuchen, Metadaten für diese abgeleitete Klasse zu überschreiben, eine Ausnahme ausgelöst.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.

Die angegebenen Metadaten werden mit den Eigenschafts Metadaten für die Abhängigkeits Eigenschaft zusammengeführt, so wie Sie auf dem Basis Besitzer vorhanden sind.The supplied metadata is merged with the property metadata for the dependency property as it exists on the base owner. Alle Eigenschaften, die in den ursprünglichen Basis Metadaten angegeben wurden, bleiben erhalten. nur die Merkmale, die speziell in den neuen Metadaten geändert wurden, überschreiben die Eigenschaften der Basis Metadaten.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. Einige Merkmale wie DefaultValue werden ersetzt, wenn Sie in den neuen Metadaten angegeben werden.Some characteristics such as DefaultValue are replaced if specified in the new metadata. Andere, wie z. b. PropertyChangedCallback, werden kombiniert.Others, such as PropertyChangedCallback, are combined. Das Zusammensetzungs Verhalten hängt von dem Eigenschaftentyp ab, der für die Überschreibung verwendet wird.The merge behavior depends on the property metadata type being used for the override. Weitere Informationen finden Sie unter Metadaten für Abhängigkeits Eigenschaften und Framework-Eigenschaften Metadaten.For details, see Dependency Property Metadata and Framework Property Metadata.

Gilt für: