PROPERTY GET |
Demande la propriété |
|---|---|
| Visual Basic | |
Syntaxe
|
[Public | Private][Static] Property Get name [(arglist)][As type] [statements] [name = expression] [Exit Property] [statements] [name = expression] End Property |
Paramètres
| Nom | Description |
|---|---|
| arglist | Ce paramètre permet d'indiquer la liste des variables représentant les paramètres passés à la procédure Property Get lorsqu'elle est appelée. Les paramètres multiples sont séparés par des virgules. Le nom et le type de données de chaque argument dans une procédure Property Get doivent être les mêmes que les paramètres correspondants dans une procédure Property Let (s'il en existe un). |
| expression | Ce paramètre permet d'indiquer la valeur de la propriété renvoyée par la procédure définie par l'instruction Property Get. |
| name | Ce paramètre permet d'indiquer le nom de la procédure Property Get; suivant les conventions de dénomination des variables standard, sauf que le nom peut être identique à une procédure Property Let ou Property Set dans le même module. |
| statements | Ce paramètre permet d'indiquer tout groupe d'instructions à exécuter dans le corps de la procédure Property Get. |
| type | Ce paramètre permet d'indiquer le type de données de la valeur renvoyée par la procédure Property Get; peut être Byte, Boolean, Integer, Long, Currency, Single, Double, Date, String (sauf de longueur fixe), Object, Variant ou de type défini par l'utilisateur. Les tableaux de tout type ne peuvent pas être retournés, mais un Variant contenant un tableau le peut. Le type de retour d'une procédure Property Get doit être du même type de données que le dernier (ou parfois le seul) paramètre d'une procédure Property Let correspondante (s'il en existe une) définissant la valeur affectée à la propriété sur le côté droit d'une expression. |
| Public | Ce paramètre permet d'indiquer que la procédure Property Get est accessible à toutes les autres procédures de tous les modules. |
| Private | Ce paramètre permet d'indiquer que la procédure Property Get est accessible uniquement aux autres procédures du module dans lequel elle est déclarée. |
| Static | Ce paramètre permet d'indiquer que les variables locales de la procédure Property Get sont conservées entre les appels. L'attribut Static n'affecte pas les variables déclarées en dehors de la procédure Property Get, même si elles sont utilisées dans la procédure. |
Description
Cette instruction permet de déclarer le nom, les paramètres et le code formant le corps d'une procédure Property, obtenant la valeur d'une propriété.
Remarques
- Le paramètre arglist a la syntaxe suivantes :
- Si elles ne sont pas explicitement spécifiées à l'aide de Public ou Private, les procédures Property sont publiques par défaut. Si Static n'est pas utilisé, la valeur des variables locales n'est pas conservée entre les appels.
- Tout le code exécutable doit être dans des procédures. Vous ne pouvez pas définir une procédure Property Get dans une autre procédure Property, Sub ou Function.
- Les mots clefs Exit Property provoquent une sortie immédiate d'une procédure Property Get. L'exécution du programme se poursuit avec l'instruction suivant l'instruction ayant appelé la procédure Property Get. N'importe quel nombre d'instructions Exit Property peut apparaître n'importe où dans une procédure Property Get.
- Comme une procédure Sub et Property Let, une procédure Property Get est une procédure distincte pouvant prendre des paramètres, exécuter une série d'instructions et modifier les valeurs de ses paramètres. Cependant, contrairement à une procédure Sub ou Property Let, vous pouvez utiliser une procédure Property Get sur le côté droit d'une expression de la même manière que vous utilisez un Function ou un nom de propriété lorsque vous souhaitez renvoyer la valeur d'une propriété.
| [ByVal | ByRef] varname[( )][As type] |
et les parties suivantes :
| Partie | Description |
|---|---|
| ByVal | Ce paramètre permet d'indiquer que le paramètre est passé par valeur. |
| ByRef | Ce paramètre permet d'indiquer que le paramètre est passé par référence. |
| varname | Ce paramètre permet d'indiquer le nom de la variable représentant le paramètre; suit les conventions de dénomination des variables standard. |
| type | Ce paramètre permet d'indiquer le type de données du paramètre passé à la procédure Property Get; peut être Byte, Boolean, Integer, Long, Currency, Single, Double, Date, String (longueur variable uniquement), Object, Variant, un type défini par l'utilisateur ou un type d'objet. |
Dernière mise à jour : Jeudi, le 31 Décembre 2020