Freigeben über


DependencyProperty.Register Methode

Definition

Registriert eine Abhängigkeitseigenschaft mit dem angegebenen Eigenschaftennamen, Eigenschaftentyp, Besitzertyp und Eigenschaftenmetadaten für die Eigenschaft. Verwenden Sie diese Methode beim Definieren oder Initialisieren einer von DependencyObject abgeleiteten Klasse, die die registrierte Abhängigkeitseigenschaft besitzt.

 static DependencyProperty Register(winrt::hstring const& name, TypeName const& propertyType, TypeName const& ownerType, PropertyMetadata const& typeMetadata);
public static DependencyProperty Register(string name, System.Type propertyType, System.Type ownerType, PropertyMetadata typeMetadata);
function register(name, propertyType, ownerType, typeMetadata)
Public Shared Function Register (name As String, propertyType As Type, ownerType As Type, typeMetadata As PropertyMetadata) As DependencyProperty

Parameter

name
String

winrt::hstring

Der Name der zu registrierenden Abhängigkeitseigenschaft.

propertyType
TypeName Type

Der Typ der Eigenschaft als Typreferenz (System.Type für Microsoft .NET, eine TypeName-Hilfsstruktur für Visual C++-Komponentenerweiterungen (C++/CX)).

ownerType
TypeName Type

Der Besitzertyp, der die Abhängigkeitseigenschaft als Typreferenz registriert (System.Type für Microsoft .NET, eine TypeName-Hilfsstruktur für Visual C++-Komponentenerweiterungen (C++/CX)).

typeMetadata
PropertyMetadata

Eine eigenschaftsmetadaten instance. Dies kann einen Standardwert und eine PropertyChangedCallback-Implementierungsreferenz enthalten. Das Übergeben null für diesen Parameter entspricht dem Übergeben eines neuen PropertyMetadata-instance erstellt, indem PropertyMetadata.Create mit null als Standardwertparameter aufgerufen wird.

Gibt zurück

Ein Abhängigkeitseigenschaftsbezeichner, der in der Regel in einem öffentlichen statischen schreibgeschützten Feld in Ihrer abgeleiteten DependencyObject-Klasse gespeichert wird. Der Bezeichner wird dann sowohl von Ihrem eigenen Code als auch von jedem Benutzercode von Drittanbietern verwendet, um später auf die Abhängigkeitseigenschaft zu verweisen, z. B. für Vorgänge wie das programmgesteuerte Festlegen des Werts oder das Anfügen einer Bindung im Code.

Hinweise

Das Registrieren einer benutzerdefinierten Abhängigkeitseigenschaft wird ausführlich (mit Beispielen) im Thema Benutzerdefinierte Abhängigkeitseigenschaften beschrieben.

Das Registrieren einer Abhängigkeitseigenschaft ist in der Regel etwas, das Sie nur dann tun, wenn eine App zum ersten Mal gestartet wird oder von DependencyObject abgeleitete Klassen, die durch Ihren App-Code definiert werden, zuerst verwendet werden. Sie müssen die Abhängigkeitseigenschaften frühzeitig in der App-Lebensdauer registrieren, um sicherzustellen, dass anderer Code und XAML in Ihrer App nicht versuchen, die Abhängigkeitseigenschaften zu verwenden, bevor sie registriert und verfügbar sind. Wie und wann genau registriert werden soll, hängt von der Programmiersprache ab. Für C# oder Microsoft Visual Basic ist es üblich, Abhängigkeitseigenschaften während der statischen Klasseninitialisierung der Klasse zu registrieren, die die Abhängigkeitseigenschaft besitzt. Auf diese Weise ruft jeder Code oder XAML, der die instance initialisiert, diese statische Konstruktion auf und registriert die Abhängigkeitseigenschaft. Für Visual C++-Komponentenerweiterungen (C++/CX) ist die Initialisierung statischer Klassen kein verfügbares Verfahren. Daher müssen Sie in der Regel eine appweite Hilfsmethode definieren, die alle benutzerdefinierten Abhängigkeitseigenschaften registriert, die Ihre App verwenden möchte, als Teil der Application-Objektinitialisierung . Beispiele für das Registrieren benutzerdefinierter Abhängigkeitseigenschaften, einschließlich einiger spezieller Techniken, die für Visual C++-Komponentenerweiterungen (C++/CX) erforderlich sind, finden Sie unter Benutzerdefinierte Abhängigkeitseigenschaften.

Gilt für:

Weitere Informationen