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 possédera 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é, comme 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 revient à transmettre 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
La procédure d’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 une opération que vous effectuez uniquement lorsqu’une application démarre pour la première fois ou que les classes dérivées de DependencyObject définies par le code de votre 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 les autres codes et XAML de votre application n’essaient pas d’utiliser les propriétés de dépendance avant qu’elles ne soient 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 propriétaire de la propriété de dépendance. De cette façon, n’importe quel code ou XAML qui initialise l’instance appelle cette construction statique et inscrit la propriété de dépendance. Pour les extensions de composant 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 inscrit toutes les propriétés de dépendance personnalisées que votre application a l’intention d’utiliser, dans le cadre de l’initialisation de l’objet Application . Pour obtenir des exemples montrant comment et quand inscrire des propriétés de dépendance personnalisées, notamment certaines techniques spéciales nécessaires pour les extensions de composants Visual C++ (C++/CX), consultez Propriétés de dépendance personnalisées.