Property Let, instruction

Microsoft VBScript

Microsoft® Visual Basic® Scripting Edition Property Let, instruction

Description

Déclare, dans un bloc Class, le nom, les arguments et le code formant une procédure Property qui affecte (définit) la valeur d'une propriété.

Syntaxe

[Public | Private] Property Let name ([arglist,] value)
    [statements]
    [Exit Property]
    [statements]
End Property
La syntaxe de l'instruction Property Let comprend les éléments suivants :

Élément Description

Public Indique que la procédure Property Let est accessible par toutes les procédures contenues dans les scripts.

Private Indique que la procédure Property Let est accessible seulement par les autres procédures du bloc Class où elle est déclarée.

name Nom de la procédure Property Let ; 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 Get 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 Let lorsqu'elle est appelée. Les arguments sont séparés par des virgules. Le nom de chaque argument d'une procédure Property Let doit être le même que celui de l'argument correspondant dans une procédure Property Get. De plus, la procédure Property Let devra toujours posséder un argument supplémentaire par rapport à la procédure Property Get correspondante. Cet argument représente la valeur qui est couramment affectée à la propriété.

value Variable qui contient la valeur affectée à la propriété. Lorsque la procédure est appelée, cet argument apparaît à la droite de l'expression à l'origine de l'appel.
statements Tout groupe d'instructions à exécuter à l'intérieur d'une procédure Property Let.

Remarque  Chaque instruction Property Let doit définir au moins un argument pour la procédure qu'il traite. Cet argument, ou le dernier argument s'il en existe plusieurs, contient la valeur réelle qui sera affectée à la propriété lorsque la procédure définie par l'instruction Property Let sera appelée. Cet argument est appelé value dans la syntaxe précédente.

Notes

Si elles ne sont pas explicitement spécifiées comme Public ou Private, les procédures Property Let 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 Let n'est pas préservée entre les appels de la procédure.
Vous ne pouvez pas définir une procédure Property Let à l'intérieur d'une autre procédure (en d'autres termes, Function ou Property Get).
L'instruction Exit Property quitte immédiatement la procédure Property Let en cours. Le programme continue en passant à l'instruction qui suit celle à l'origine de l'appel de la procédure Property Let. Plusieurs instructions Exit Property peuvent apparaître dans une procédure Property Let.
Comme les procédures Function et Property Get, une procédure Property Let 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 Function et Property Get, ces deux procédures renvoyant une valeur, utilisez une procédure Property Let à gauche d'une expression d'affectation de propriété.

previous page start next page

Élément	Description
Public	Indique que la procédure Property Let est accessible par toutes les procédures contenues dans les scripts.
Private	Indique que la procédure Property Let est accessible seulement par les autres procédures du bloc Class où elle est déclarée.
name	Nom de la procédure Property Let ; 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 Get 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 Let lorsqu'elle est appelée. Les arguments sont séparés par des virgules. Le nom de chaque argument d'une procédure Property Let doit être le même que celui de l'argument correspondant dans une procédure Property Get. De plus, la procédure Property Let devra toujours posséder un argument supplémentaire par rapport à la procédure Property Get correspondante. Cet argument représente la valeur qui est couramment affectée à la propriété.
value	Variable qui contient la valeur affectée à la propriété. Lorsque la procédure est appelée, cet argument apparaît à la droite de l'expression à l'origine de l'appel.
statements	Tout groupe d'instructions à exécuter à l'intérieur d'une procédure Property Let.


Remarque Chaque instruction Property Let doit définir au moins un argument pour la procédure qu'il traite. Cet argument, ou le dernier argument s'il en existe plusieurs, contient la valeur réelle qui sera affectée à la propriété lorsque la procédure définie par l'instruction Property Let sera appelée. Cet argument est appelé value dans la syntaxe précédente.