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è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 propriétaire qui inscrit la propriété de dépendance, en tant que référence de type..
- typeMetadata
- PropertyMetadata
Instance de métadonnées de propriété. Cela peut contenir une valeur par défaut et une référence d’implémentation PropertyChangedCallback . La transmission null de ce paramètre équivaut à passer une nouvelle instance PropertyMetadata créée en appelant PropertyMetadata.Create comme null paramètre de valeur par défaut.
Retours
Identificateur de propriété de dépendance qui est généralement stocké dans un champ en lecture seule statique public dans votre classe dérivée DependencyObject . L’identificateur est ensuite utilisé à la fois par votre propre code et 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
Comment inscrire une propriété de dépendance personnalisée est décrite en détail (avec des exemples) dans les propriétés de dépendance personnalisées de la rubrique.
L’inscription d’une propriété de dépendance est généralement un élément que vous effectuez uniquement lorsqu’une application démarre d’abord ou que les classes dérivées 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 dans votre application n’essaient pas d’utiliser les propriétés de dépendance avant qu’elles ne soient inscrites et disponibles. Exactement comment et quand inscrire varie en fonction du langage de programmation. Pour C#, il est courant d’inscrire des propriétés de dépendance pendant l’initialisation de classe statique de la classe propriétaire de la propriété de dépendance. Ainsi, tout code ou XAML qui initialise l’instance appelle cette construction statique et inscrit la propriété de dépendance. Pour C++, l’initialisation de classe statique n’est pas une technique disponible. Vous devez donc 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 de la façon et du moment d’inscrire des propriétés de dépendance personnalisées, notamment certaines techniques spéciales nécessaires pour C++, consultez les propriétés de dépendance personnalisées.