Partage via


DependencyProperty.Register Méthode

Définition

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 DependencyProperty

Paramètres

name
String

winrt::hstring

Nom de la propriété de dépendance à inscrire.

propertyType
TypeName Type

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)).

ownerType
TypeName Type

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.

S’applique à

Voir aussi