DependencyProperty.AddOwner DependencyProperty.AddOwner DependencyProperty.AddOwner DependencyProperty.AddOwner Method

Definition

Fügt einen weiteren Typ als Besitzer einer Abhängigkeitseigenschaft hinzu, die bereits für einen Typ registriert wurde.Adds another type as an owner of a dependency property that has already been registered to a type.

Überlädt

AddOwner(Type) AddOwner(Type) AddOwner(Type) AddOwner(Type)

Fügt einen weiteren Typ als Besitzer einer Abhängigkeitseigenschaft hinzu, die bereits registriert wurde.Adds another type as an owner of a dependency property that has already been registered.

AddOwner(Type, PropertyMetadata) AddOwner(Type, PropertyMetadata) AddOwner(Type, PropertyMetadata) AddOwner(Type, PropertyMetadata)

Fügt einen anderen Typ als Besitzer einer Abhängigkeitseigenschaft hinzu, die bereits registriert wurde. Dabei werden Abhängigkeitseigenschaft-Metadaten für die Abhängigkeitseigenschaft bereitgestellt, wie sie für den bereitgestellten Besitzertyp vorhanden sind.Adds another type as an owner of a dependency property that has already been registered, providing dependency property metadata for the dependency property as it will exist on the provided owner type.

AddOwner(Type) AddOwner(Type) AddOwner(Type) AddOwner(Type)

Fügt einen weiteren Typ als Besitzer einer Abhängigkeitseigenschaft hinzu, die bereits registriert wurde.Adds another type as an owner of a dependency property that has already been registered.

public:
 System::Windows::DependencyProperty ^ AddOwner(Type ^ ownerType);
public System.Windows.DependencyProperty AddOwner (Type ownerType);
member this.AddOwner : Type -> System.Windows.DependencyProperty
Public Function AddOwner (ownerType As Type) As DependencyProperty

Parameter

ownerType
Type Type Type Type

Der Typ, der als ein Besitzer dieser Abhängigkeitseigenschaft hinzugefügt werden soll.The type to add as an owner of this dependency property.

Gibt zurück

Ein Verweis auf den ursprünglichen DependencyProperty-Bezeichner, der die Abhängigkeitseigenschaft angibt.A reference to the original DependencyProperty identifier that identifies the dependency property. Dieser Bezeichner sollte von der hinzufügenden Klasse als public static readonly-Feld verfügbar gemacht werden.This identifier should be exposed by the adding class as a public static readonly field.

Hinweise

Diese Methode ermöglicht das Eigenschaftensystem Abhängigkeitseigenschaft für einen Typ zu erkennen, die nicht diese Abhängigkeitseigenschaft ursprünglich registriert hat.This method enables the property system to recognize a dependency property on a type that did not register that particular dependency property initially.

In der Regel AddOwner wird verwendet, um Abhängigkeitseigenschaften Klassen hinzufügen, die nicht bereits die Abhängigkeitseigenschaft über Vererbung von verwalteten Klasse verfügbar machen (klassenvererbung würde dazu führen, dass die Wrappereigenschaften, die von der abgeleiteten Klasse geerbt werden und somit wird allgemein Membertabelle bietet Zugriff auf die Abhängigkeitseigenschaft bereits).Typically, AddOwner is used to add dependency properties to classes that do not already expose that dependency property through managed class inheritance (class inheritance would cause the wrapper properties to be inherited by the derived class, and thus would provide general members-table access to the dependency property already). AddOwner ermöglicht das Eigenschaftensystem Abhängigkeitseigenschaft für einen Typ zu erkennen, die nicht die Abhängigkeitseigenschaft ursprünglich registriert hat.AddOwner enables the property system to recognize a dependency property on a type that did not register that dependency property initially.

Diese Signatur lässt sich nicht zum Angeben von Metadaten.This signature does not allow for specifying metadata. Wenn Sie diese Methode verwenden, wird die Metadaten automatisch für die neue generiert DependencyProperty und ihren Besitzertyp.When you use this method, the metadata is automatically generated for the new DependencyProperty and its owner type. Die automatisch generierten Metadaten ist das Ergebnis der zusammengeführten Metadaten aller Basistypen, die diese Eigenschaft definiert haben.The auto-generated metadata is the result of the merged metadata from all of the base types that have this property defined. Wenn keine zusammengeführte Metadaten verfügbar ist, wird die Standardmetadaten für die Eigenschaft verwendet.If no merged metadata is available, then the default metadata for the property is used. Wenn die Eigenschaft, mithilfe registriert ist der RegisterAttached -Methode, und klicken Sie dann auf die Standardmetadaten, ist identisch mit den Metadaten, die erstellt wird RegisterAttached aufgerufen wurde.If the property is registered by using the RegisterAttached method, then the default metadata is the same as the metadata that is created when RegisterAttached was called. Andernfalls die PropertyMetadata -Objekt wird erstellt, mit der DefaultValue -Eigenschaft auf den Standardwert für den Eigenschaftentyp und alle anderen Eigenschaften festgelegt die PropertyMetadata nastaven NA hodnotu null.Otherwise, the PropertyMetadata object is created with the DefaultValue property set to the property type's default and all other properties of the PropertyMetadata is set to null. Verwenden der AddOwner(Type, PropertyMetadata) Signatur, wenn Metadaten für die Version der Abhängigkeitseigenschaft bereitgestellt, wie in den bereitgestellten Typ hinzugefügt werden sollen.Use the AddOwner(Type, PropertyMetadata) signature if you want to provide metadata for the version of the dependency property as added to the provided type.

Der Rückgabewert dieser Methode wird in der Regel zum Deklarieren und einzugehen, die Abhängigkeitseigenschaft Bezeichner einer Abhängigkeitseigenschaft.The return value of this method is typically used to declare and expose the dependency property by storing a dependency property identifier. Der Bezeichner bietet Zugriff auf die Abhängigkeitseigenschaft, wenn das Eigenschaftensystem aufgerufen werden soll APIsAPIs auf die hinzufügende Besitzerklasse für die Abhängigkeitseigenschaft, insbesondere, wenn er vorhanden.The identifier provides access to the dependency property if you want to call property system APIsAPIs against the dependency property, particularly as it exists on the adding owner class. Der gleiche Name für den ursprünglichen Besitzer und hinzugefügte Benutzer sollte verwendet werden, die ähnliche Funktionen an.The same property name for both original owner and added owner should be used to indicate the similar functionality. Verwenden Sie die DependencyProperty Rückgabewert der AddOwner Methode der Bezeichner der Abhängigkeitseigenschaft definieren, sowie zum Deklarieren CLRCLR Eigenschaftenwrapper für Abhängigkeitseigenschaften, die mithilfe von Typen hinzugefügt werden AddOwner.You should use the DependencyProperty return value of the AddOwner method to define the dependency property identifier, and also to declare CLRCLR property wrappers, for dependency properties that are added to types using AddOwner.

Die AddOwner oben empfohlenen Methode wird verwendet, wenn es sich bei Erstellen von Abhängigkeitseigenschaften, die innerhalb von deklariert werden WPFWPF.The AddOwner methodology recommended above is used when creating the dependency properties that are declared within WPFWPF. Beispielsweise sowohl Border und Control definieren eine BorderBrush Abhängigkeitseigenschaft, die ähnliche Funktionen aufweisen.For instance, both Border and Control define a BorderBrush dependency property, which have similar functionality. Control definiert die BorderBrush Eigenschaft im Eigenschaftensystem durch Aufrufen von AddOwner basierend auf dem ursprünglichen Besitzer Border und ihre registrierte BorderBrushProperty Abhängigkeit Eigenschaft Bezeichner.Control defines its BorderBrush property to the property system by calling AddOwner based on the original owner Border and its registered BorderBrushProperty dependency property identifer. Die AddOwner zurückgegeben Wert wird dann verwendet, um ein neues statisches DependencyProperty Feld (BorderBrushProperty) für diese Eigenschaft auf den Besitzer hinzugefügt und ein BorderBrush Eigenschaftenwrapper auch deklariert wird.The AddOwner return value is then used to establish a new static DependencyProperty field (BorderBrushProperty) for that property on the added owner, and a BorderBrush property wrapper is also declared.

AddOwner(Type, PropertyMetadata) AddOwner(Type, PropertyMetadata) AddOwner(Type, PropertyMetadata) AddOwner(Type, PropertyMetadata)

Fügt einen anderen Typ als Besitzer einer Abhängigkeitseigenschaft hinzu, die bereits registriert wurde. Dabei werden Abhängigkeitseigenschaft-Metadaten für die Abhängigkeitseigenschaft bereitgestellt, wie sie für den bereitgestellten Besitzertyp vorhanden sind.Adds another type as an owner of a dependency property that has already been registered, providing dependency property metadata for the dependency property as it will exist on the provided owner type.

public:
 System::Windows::DependencyProperty ^ AddOwner(Type ^ ownerType, System::Windows::PropertyMetadata ^ typeMetadata);
public System.Windows.DependencyProperty AddOwner (Type ownerType, System.Windows.PropertyMetadata typeMetadata);
member this.AddOwner : Type * System.Windows.PropertyMetadata -> System.Windows.DependencyProperty
Public Function AddOwner (ownerType As Type, typeMetadata As PropertyMetadata) As DependencyProperty

Parameter

ownerType
Type Type Type Type

Der Typ, der als Besitzer dieser Abhängigkeitseigenschaft hinzugefügt werden soll.The type to add as owner of this dependency property.

typeMetadata
PropertyMetadata PropertyMetadata PropertyMetadata PropertyMetadata

Die Metadaten, die die Abhängigkeitseigenschaft beschreiben, wie sie für den bereitgestellten Typ vorhanden sind.The metadata that qualifies the dependency property as it exists on the provided type.

Gibt zurück

Ein Verweis auf den ursprünglichen DependencyProperty-Bezeichner, der die Abhängigkeitseigenschaft angibt.A reference to the original DependencyProperty identifier that identifies the dependency property. Dieser Bezeichner sollte von der hinzufügenden Klasse als public static readonly-Feld verfügbar gemacht werden.This identifier should be exposed by the adding class as a public static readonly field.

Hinweise

Diese Methode ermöglicht das Eigenschaftensystem Abhängigkeitseigenschaft für einen Typ zu erkennen, die nicht diese Abhängigkeitseigenschaft ursprünglich registriert hat.This method enables the property system to recognize a dependency property on a type that did not register that particular dependency property initially.

Der Rückgabewert dieser Methode wird zum Deklarieren und verfügbar zu machen die Abhängigkeitseigenschaft, insbesondere, wie sie auf die hinzufügende Besitzerklasse vorhanden ist.The return value of this method is used to declare and expose the dependency property, particularly as it exists on the adding owner class. Im Allgemeinen sollte der gleiche Name für den ursprünglichen Besitzer und Besitzer hinzugefügt verwendet werden, die ähnliche Funktionen an.Generally, the same property name for both original owner and added owner should be used to indicate the similar functionality. Es wird empfohlen, die Bezeichner, sowie neue verfügbar zu machen CLRCLR Eigenschaftenwrapper für Abhängigkeitseigenschaften, die mithilfe von Typen hinzugefügt werden AddOwner.It is good practice to expose the identifiers, as well as new CLRCLR property wrappers, for dependency properties that are added to types using AddOwner.

Die AddOwner oben empfohlenen Methoden wird beim Erstellen verwendet APIsAPIs innerhalb deklarierten WPFWPF.The AddOwner methodology recommended above is used when creating APIsAPIs declared within WPFWPF. Beispielsweise sowohl Border und Control definieren eine BorderBrush Abhängigkeitseigenschaft, die ähnliche Funktionen aufweisen.For instance, both Border and Control define a BorderBrush dependency property, which have similar functionality. Control definiert die BorderBrush Eigenschaft im Eigenschaftensystem durch Aufrufen von AddOwner für den ursprünglichen Besitzer Border und ihre registrierte BorderBrushProperty Abhängigkeit Eigenschaft Bezeichner.Control defines its BorderBrush property to the property system by calling AddOwner on original owner Border and its registered BorderBrushProperty dependency property identifer. Die AddOwner zurückgegeben Wert wird dann verwendet, um ein neues statisches DependencyProperty Feld (BorderBrushProperty) für diese Eigenschaft auf den Besitzer hinzugefügt und ein BorderBrush Eigenschaftenwrapper auch deklariert wird.The AddOwner return value is then used to establish a static DependencyProperty field (BorderBrushProperty) for that property on the added owner, and a BorderBrush property wrapper is also declared.

Der Bezeichner des hinzugefügten Besitzers Abhängigkeitseigenschaft zu verwendende für Vorgänge wie z. B. GetValue.The added owner's dependency property identifier should be used for operations such as GetValue. Jedoch typspezifische Vorgänge im Zusammenhang mit Typen oder Instanzen der Klasse, die hinzugefügt wurde, wie Sie weiterhin Besitzer über unterschiedliche Metadaten zurückgeben die erwarteten Ergebnisse auch wenn die ursprüngliche (nicht des hinzugefügten Besitzers) in Abhängigkeit der Bezeichner angegeben wird Aufrufe von Methoden wie z. B. GetValue oder GetMetadata.However, type-specific operations involving either types or instances of the class that was added as owner with different metadata will still return the expected results even if the original (not the added owner's) dependency property identifier is specified in calls to methods such as GetValue or GetMetadata. Die Metadaten für den hinzugefügten Besitzer wird aufrechterhalten, durch die AddOwner selbst, nicht unbedingt auf die verwiesen wird ausschließlich von Feld-ID hinzufügen von Owner-Klasse aufrufen.The metadata for the added owner is perpetuated by the AddOwner call itself, not necessarily referenced exclusively by the adding owner class identifier field. Dennoch ist es empfiehlt sich, die Bezeichner, sowie neue CLRCLR Eigenschaftenwrapper für Abhängigkeitseigenschaften, die mithilfe von Typen hinzugefügt werden AddOwner, da die Abweichung zwischen geschieht dies nicht erstellt werden. die CLRCLR und XAMLXAML -Darstellung der Eigenschaften.Nevertheless, it is good practice to expose the identifier, as well as new CLRCLR property wrappers, for dependency properties that are added to types using AddOwner, because failing to do so creates disparity between the CLRCLR and XAMLXAML representations of your properties.

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.Any characteristics that were specified in the original base metadata will persist. Nur die Merkmale, die insbesondere in den neuen Metadaten geändert wurden, werden die Merkmale der grundlegenden Metadaten überschrieben.Only those characteristics that were specifically changed in the new metadata will override the characteristics of the base metadata. Einige Merkmale, z. B. DefaultValue, ersetzt werden, wenn sie in den neuen Metadaten angegeben sind.Some characteristics, such as DefaultValue, are replaced if they are 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.

Gilt für: