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

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) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) 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) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey) OverrideMetadata(Type, PropertyMetadata, DependencyPropertyKey) 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) OverrideMetadata(Type, PropertyMetadata) OverrideMetadata(Type, PropertyMetadata) 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 Type Type 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 PropertyMetadata PropertyMetadata 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ängigkeitseigenschaften sollte überschrieben werden, bevor Sie das Eigenschaftensystem die Abhängigkeitseigenschaft verwendet.Dependency property metadata should be overridden before the property system uses the dependency property. Dies entspricht der Zeit, die bestimmte Instanzen erstellt werden, mit der Klasse, die die Abhängigkeitseigenschaft registriert.This equates to the time that specific instances are created using the class that registers the dependency property. Aufrufe von OverrideMetadata sollte nur ausgeführt werden, in den statischen Konstruktoren des Typs, der sich selbst als die forType Parameter dieser Methode oder über eine ähnliche Instanziierung.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. Es wird versucht, Metadaten zu ändern, nachdem die Instanzen des Besitzertyps vorhanden sind, werden keine Ausnahmen ausgelöst, es wird aber führt zu inkonsistentem Verhalten im Eigenschaftensystem.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 Metadaten für einen bestimmten abgeleiteten Klasse außer Kraft setzen, die mit dieser Methode eingerichtet wurde, werden nachfolgende Versuche zum Überschreiben von Metadaten in dieser abgeleiteten Klasse 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 angegebene Metadaten wird mit die Eigenschaftenmetadaten für die Abhängigkeitseigenschaft zusammengeführt, wie sie auf der Basis Besitzer vorhanden ist.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 grundlegenden Metadaten angegeben wurden, werden beibehalten. nur die Merkmale, die insbesondere in den neuen Metadaten geändert wurden, werden die Merkmale der grundlegenden Metadaten überschrieben.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 z. B. DefaultValue ersetzt werden, wenn in den neuen Metadaten angegeben.Some characteristics such as DefaultValue are replaced if specified in the new metadata. Andere, z. B. PropertyChangedCallback, kombiniert werden.Others, such as PropertyChangedCallback, are combined. Letzten Endes hängt das mergeverhalten der Metadaten-Eigenschaftentyp, die für das Überschreiben verwendet wird, also das hier beschriebene Verhalten für die vorhandene Eigenschaft Metadaten-Klassen, die von verwendet WPFWPF Abhängigkeitseigenschaften.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ängigkeitseigenschaften und Framework-Eigenschaftenmetadaten.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)

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 Type Type 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 PropertyMetadata PropertyMetadata 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 DependencyPropertyKey DependencyPropertyKey DependencyPropertyKey

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

Hinweise

Diese Signatur bietet die zugrunde liegende Implementierung für den Bezeichner für eine schreibgeschützte Abhängigkeitseigenschaft (DependencyPropertyKey) Methode.This signature provides underlying implementation for a read-only dependency property identifier (DependencyPropertyKey) method. Wenn Metadaten für eine schreibgeschützte Abhängigkeitseigenschaft zu überschreiben, verwenden Sie OverrideMetadata(Type, PropertyMetadata).If overriding metadata for a read-write dependency property, use OverrideMetadata(Type, PropertyMetadata).

Metadaten für Abhängigkeitseigenschaften sollte überschrieben werden, bevor Sie das Eigenschaftensystem die Abhängigkeitseigenschaft verwendet.Dependency property metadata should be overridden before the property system uses the dependency property. Dies entspricht der Zeit, die bestimmte Objekte erstellt werden, für die Klasse, die die Abhängigkeitseigenschaft registriert.This equates to the time that specific objects are created for the class that registers the dependency property. Aufrufe von OverrideMetadata sollte nur ausgeführt werden, in den statischen Konstruktoren des Typs, der sich selbst als die forType Parameter dieser Methode oder über eine ähnliche Instanziierung.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. Es wird versucht, Metadaten zu ändern, nachdem die Instanzen des Besitzertyps vorhanden sind, werden keine Ausnahmen ausgelöst, es wird aber führt zu inkonsistentem Verhalten im Eigenschaftensystem.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 Metadaten für einen bestimmten abgeleiteten Klasse außer Kraft setzen, die mit dieser Methode eingerichtet wurde, werden nachfolgende Versuche zum Überschreiben von Metadaten in dieser abgeleiteten Klasse 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 angegebene Metadaten wird mit die Eigenschaftenmetadaten für die Abhängigkeitseigenschaft zusammengeführt, wie sie auf der Basis Besitzer vorhanden ist.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 grundlegenden Metadaten angegeben wurden, werden beibehalten. nur die Merkmale, die insbesondere in den neuen Metadaten geändert wurden, werden die Merkmale der grundlegenden Metadaten überschrieben.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 z. B. DefaultValue ersetzt werden, wenn in den neuen Metadaten angegeben.Some characteristics such as DefaultValue are replaced if specified in the new metadata. Andere, z. B. PropertyChangedCallback, kombiniert werden.Others, such as PropertyChangedCallback, are combined. Der mergeverhalten hängt vom Typ der Metadaten für die Überschreibung verwendet wird ab.The merge behavior depends on the property metadata type being used for the override. Weitere Informationen finden Sie unter Metadaten für Abhängigkeitseigenschaften und Framework-Eigenschaftenmetadaten.For details, see Dependency Property Metadata and Framework Property Metadata.

Gilt für: