Déclaration de propriété
La déclaration d'une propriété dans une classe managée a été modifiée entre Extensions managées pour C++ et Visual C++ 2010.
Dans la conception des Extensions managées, chaque accesseur de propriété set ou get est spécifié comme méthode indépendante. La déclaration de chaque méthode est préfixée avec le mot clé __property. Le nom de la méthode commence par set_ ou get_, suivi du nom réel de la propriété (visible par l'utilisateur). Donc, un Vector fournissant une propriété get de coordonnée x la nommerait get_x et l'utilisateur l'appellerait x. Cette convention d'affectation de noms et la spécification séparée des méthodes reflètent réellement l'implémentation sous-jacente de la propriété à l'exécution. Par exemple, voici notre Vector avec un jeu de propriétés coordonnées :
public __gc __sealed class Vector {
public:
__property double get_x(){ return _x; }
__property double get_y(){ return _y; }
__property double get_z(){ return _z; }
__property void set_x( double newx ){ _x = newx; }
__property void set_y( double newy ){ _y = newy; }
__property void set_z( double newz ){ _z = newz; }
};
Il s'ensuit une répartition des fonctionnalités associées à une propriété et l'utilisateur doit unifier de façon lexicale les commandes get et set associées. En outre, c'est en clair. Dans la nouvelle syntaxe, plus proche de celle de C#, le mot clé property est suivi du type de la propriété et de son nom sans ornement. Les méthodes d'accès set et get sont placées dans un bloc qui suit le nom de la propriété. Notez que contrairement à C#, la signature de la méthode d'accès est spécifiée. Par exemple, voici la traduction dans la nouvelle syntaxe de l'exemple de code ci-dessus.
public ref class Vector sealed {
public:
property double x {
double get() {
return _x;
}
void set( double newx ) {
_x = newx;
}
} // Note: no semi-colon
};
Si les méthodes d'accès de la propriété reflètent des niveaux d'accès distincts - tel qu'un get public et un set private ou protected, une étiquette d'accès explicite peut être spécifiée. Par défaut, le niveau d'accès de la propriété reflète celui du niveau d'accès englobant. Par exemple, les deux méthodes get et set sont public dans la définition ci-dessus de Vector. Pour rendre la méthode set protected ou private, la définition serait modifiée comme suit :
public ref class Vector sealed {
public:
property double x {
double get() {
return _x;
}
private:
void set( double newx ) {
_x = newx;
}
} // note: extent of private culminates here …
// note: dot is a public method of Vector
double dot( const Vector^ wv );
// etc.
};
La portée d'un mot clé d'accès dans une propriété s'étend soit jusqu'à l'accolade fermante de la propriété, soit jusqu'à la spécification d'un mot clé d'accès supplémentaire. Elle ne s'étend pas au-delà de la définition de la propriété, jusqu'au niveau d'accès englobant dans lequel la propriété est définie. Dans la déclaration ci-dessus, par exemple, Vector::dot() est une méthode publique.
L'écriture des propriétés set/get pour les trois coordonnées Vector implique trois étapes :
déclarez un membre d'état privé du type approprié.
retournez-le lorsque l'utilisateur souhaite obtenir sa valeur.
assignez-lui la nouvelle valeur.
Dans la nouvelle syntaxe, une syntaxe de propriété abrégée existe pour automatiser ce modèle d'utilisation :
public ref class Vector sealed {
public:
// equivalent shorthand property syntax
property double x;
property double y;
property double z;
};
Un effet secondaire intéressant de la syntaxe de propriété abrégée est que, pendant que le membre state en arrière plan est automatiquement généré par le compilateur, il n'est pas accessible dans la classe, sauf à travers les accesseurs set/get.