Property Get, instruction

Microsoft VBScript

Microsoft® Visual Basic® Scripting Edition Property Get, instruction  Référence du langage 
Version 5 


Description
Déclare, dans un bloc Class, le nom, les arguments et le code formant une procédure Property qui obtient (renvoie) la valeur d'une propriété.
Syntaxe
[Public [Default]| Private] Property Get name [(arglist)]
    [statements]
    [[Set] name = expression]
    [Exit Property]
    [statements]
    [[Set] name = expression]
End Property

La syntaxe de l'instruction Property Get comporte les éléments suivants :

Élément Description
Public Indique que la procédure Property Get est accessible par toutes les procédures contenues dans les scripts.
Default Utilisé seulement avec le mot clé Public pour indiquer que la propriété définie dans la procédure Property Get est la propriété par défaut pour la classe.
Private Indique que la procédure Property Get est accessible par toutes les procédures inscrites dans le bloc Class où elle est déclarée.
name Nom de la procédure Property Get ; respecte les conventions standard d'affectation de noms de variable, excepté le fait que ce nom peut être le même que celui de la procédure Property Let ou Property Set dans un même bloc Class.
arglist Liste des variables représentant les arguments qui sont transférés à la procédure Property Get lorsqu'elle est appelée. Les arguments sont séparés par des virgules. Le nom de chaque argument d'une procédure Property Get doit être le même que celui de l'argument correspondant dans une procédure Property Let (si elle existe).
statements Tout groupe d'instructions à exécuter à l'intérieur d'une procédure Property Get.
Set Mot clé utilisé lorsqu'un objet est affecté de la valeur renvoyée par une procédure Property Get.
expression Valeur renvoyée par la procédure Property Get.

Notes
Si elles ne sont pas explicitement spécifiées comme Public ou Private, les procédures Property Get sont publiques par défaut. Elles sont accessibles par toutes les procédures contenues dans votre script. La valeur des variables locales dans une procédure Property Get n'est pas préservée entre les appels de la procédure.

Vous ne pouvez pas définir une procédure Property Get à l'intérieur d'une autre procédure (en d'autres termes, Function ou Property Let).

L'instruction Exit Property quitte immédiatement la procédure Property Get en cours. Le programme continue en passant à l'instruction qui suit celle à l'origine de l'appel de la procédure Property Get. Plusieurs instructions Exit Property peuvent apparaître dans une procédure Property Get.

Comme les procédures Sub et Property Let, une procédure Property Get est séparée et peut prendre en charge des arguments, exécuter une série d'instructions et modifier la valeur de ses arguments. En revanche, contrairement aux procédures Sub et Property Let, il est possible d'utiliser une procédure Property Get à droite d'une expression de la même manière que vous le faites avec le nom d'une instruction Function ou d'une propriété lorsque vous souhaitez renvoyer la valeur d'une propriété.