Property Set, instruction

Microsoft VBScript

Microsoft® Visual Basic® Scripting Edition Property Set, instruction

Description

Déclare, dans un bloc Class, le nom, les arguments et le code formant une procédure Property qui définit la référence à un objet.

Syntaxe

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

Élément Description

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

Private Indique que la procédure Property Set 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 Set ; 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 Let dans un même bloc Class.

arglist Liste des variables représentant les arguments qui sont transférés à la procédure Property Set lorsqu'elle est appelée. Les arguments sont séparés par des virgules. De plus, la procédure Property Set devra toujours posséder un argument supplémentaire par rapport à la procédure Property Get correspondante. Cet argument représente l'objet qui est couramment affecté à la propriété.

reference Variable contenant la référence à l'objet apparaissant à la droite de l'affectation de référence.
statements Tout groupe d'instructions à exécuter à l'intérieur d'une procédure Property Set.

Remarque  Chaque instruction Property Set 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 référence de la propriété lorsque la procédure définie par l'instruction Property Set est appelée. Cet argument est appelé référence dans la syntaxe précédente.

Notes

Si elles ne sont pas explicitement spécifiées comme Public ou Private, les procédures Property Set 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 Set n'est pas préservée entre les appels de la procédure.
Vous ne pouvez pas définir une procédure Property Set à 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 Set en cours. Le programme continue en passant à l'instruction qui suit celle à l'origine de l'appel de la procédure Property Set. Plusieurs instructions Exit Property peuvent apparaître dans une procédure Property Set.
Comme les procédures Function et Property Get, une procédure Property Set 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, ontrairement aux procédures Function et Property Get, les deux renvoyant une valeur, il est possible d'utiliser une procédure Property Set seulement à gauche de l'affection de référence à l'objet (instruction Set).

previous page start next page

Élément	Description
Public	Indique que la procédure Property Set est accessible par toutes les procédures contenues dans les scripts.
Private	Indique que la procédure Property Set 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 Set ; 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 Let dans un même bloc Class.
arglist	Liste des variables représentant les arguments qui sont transférés à la procédure Property Set lorsqu'elle est appelée. Les arguments sont séparés par des virgules. De plus, la procédure Property Set devra toujours posséder un argument supplémentaire par rapport à la procédure Property Get correspondante. Cet argument représente l'objet qui est couramment affecté à la propriété.
reference	Variable contenant la référence à l'objet apparaissant à la droite de l'affectation de référence.
statements	Tout groupe d'instructions à exécuter à l'intérieur d'une procédure Property Set.


Remarque Chaque instruction Property Set 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 référence de la propriété lorsque la procédure définie par l'instruction Property Set est appelée. Cet argument est appelé référence dans la syntaxe précédente.