DependencyProperty.Register Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Inscrit une propriété de dépendance avec le nom de propriété, le type de propriété, le type de propriétaire et les métadonnées de propriété spécifiés pour la propriété. Utilisez cette méthode lors de la définition ou de l’initialisation d’une classe dérivée DependencyObject qui sera propriétaire de la propriété de dépendance inscrite.
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 DependencyPropertyParamètres
- name
-
String
winrt::hstring
Nom de la propriété de dépendance à inscrire.
Type de la propriété, en tant que référence de type (System.Type pour Microsoft .NET, struct d’assistance TypeName pour les extensions de composant Visual C++ (C++/CX)).
Type de propriétaire qui inscrit la propriété de dépendance en tant que référence de type (System.Type pour Microsoft .NET, struct d’assistance TypeName pour les extensions de composant Visual C++ (C++/CX)).
- typeMetadata
- PropertyMetadata
Une instance de métadonnées de propriété. Il peut contenir une valeur par défaut et une référence d’implémentation PropertyChangedCallback . Passer null pour ce paramètre équivaut à passer un nouveau PropertyMetadata instance créé en appelant PropertyMetadata.Create avec null comme paramètre de valeur par défaut.
Retours
Identificateur de propriété de dépendance qui est généralement stocké dans un champ public statique en lecture seule dans votre classe dérivée DependencyObject . L’identificateur est ensuite utilisé à la fois par votre propre code et par tout code utilisateur tiers pour référencer la propriété de dépendance ultérieurement, pour des opérations telles que la définition de sa valeur par programmation ou l’attachement d’une liaison dans le code.
Remarques
L’inscription d’une propriété de dépendance personnalisée est décrite en détail (avec des exemples) dans la rubrique Propriétés de dépendance personnalisées.
L’inscription d’une propriété de dépendance est généralement quelque chose que vous faites uniquement quand une application démarre pour la première fois ou que les classes dérivées de DependencyObject définies par votre code d’application sont utilisées pour la première fois. Vous devez inscrire les propriétés de dépendance au début de la durée de vie de l’application pour vous assurer que d’autres codes et XAML de votre application n’essaient pas d’utiliser les propriétés de dépendance avant d’être inscrites et disponibles. Le mode et le moment exacts de l’inscription varient en fonction du langage de programmation. Pour C# ou Microsoft Visual Basic, il est courant d’inscrire des propriétés de dépendance lors de l’initialisation de classe statique de la classe qui possède la propriété de dépendance. De cette façon, tout code ou XAML qui initialise le instance appelle cette construction statique et inscrit la propriété de dépendance. Pour les extensions de composants Visual C++ (C++/CX)), l’initialisation de classe statique n’étant pas une technique disponible, vous devez généralement définir une méthode d’assistance à l’échelle de l’application qui enregistre toutes les propriétés de dépendance personnalisées que votre application envisage d’utiliser, dans le cadre de l’initialisation de l’objet Application . Pour obtenir des exemples de comment et de quand inscrire des propriétés de dépendance personnalisées, y compris certaines techniques spéciales nécessaires pour les extensions de composants Visual C++ (C++/CX), consultez Propriétés de dépendance personnalisées.