Private, instruction
Utilisé au niveau du module pour déclarer des variables privées et allouer de l’espace de stockage.
Syntaxe
Private [ WithEvents ] varname [ ( [ indices ] ) ] [ As [ New ] type ]
[ , [ WithEvents ] varname [ ( [ indices ] ) ] [ As [ New ] type ]] . . . . .
La syntaxe de l’instruction Private comprend les éléments suivants :
| Élément | Description |
|---|---|
| WithEvents | Optional. Mot clé indiquant que l’argument varname est une variable objet utilisée pour répondre aux événements déclenchés par un objet ActiveX. WithEvents est valide uniquement dans les modules de classe. Vous pouvez déclarer autant de variables individuelles que vous le souhaitez à l’aide de WithEvents, mais vous ne pouvez pas créer de tableaux avec WithEvents, ni utiliser New avec WithEvents. |
| varname | Obligatoire. Nom de la variable ; respecte les conventions d'affectation des noms de variables standard. |
| subscripts | Facultatif. Dimensions d'une variable tableau ; vous pouvez déclarer jusqu'à 60 dimensions.
L’argument indices utilise la syntaxe suivante : [ lowerTo ] upper [ , [ lowerTo ] upper ] . . . Lorsque pas explicitement indiqué dans lower, la limite inférieure d’une matrice est contrôlée par la déclarationOption Base. La limite inférieure correspond à zéro si aucune instructionOption Base n’est présente. |
| New | Optional. Mot clé qui autorise la création implicite d’un objet. Si vous utilisez New lors de la déclaration de la variable objet, une nouvelle instance de l’objet est créée lors de la première référence à celle-ci. Vous n’avez donc pas besoin d’utiliser l’instruction Set pour affecter la référence d’objet. La nouvelle mot clé ne peut pas être utilisée pour déclarer des variables d’un type de données intrinsèque. Il ne peut pas non plus être utilisé pour déclarer des instances d’objets dépendants, ni avec WithEvents. |
| type | Optional. Type de données de la variable ; Peut être Byte, Boolean, Integer, Long, Currency, Single, Double, Decimal (non pris en charge actuellement), Date, String (pour les chaînes de longueur variable), Stringlength (pour les chaînes de longueur fixe), Object, Variant, un type défini par l’utilisateur ou un type d’objet. Utiliser une clause distincteen tant quetype pour chaque variable définie. |
Remarques
Les variables Private ne sont disponibles que pour le module dans lequel elles sont déclarées.
Utilisez l’instruction Private pour déclarer le type de données d’une variable. Par exemple, l’instruction suivante déclare une variable en tant que variable de type Integer :
Private NumberOfEmployees As Integer
Vous pouvez également utiliser une instruction Private pour déclarer le type objet d’une variable. L’instruction suivante déclare une variable pour une nouvelle instance d’une feuille de calcul :
Private X As New Worksheet
Si new mot clé n’est pas utilisé lors de la déclaration d’une variable objet, la variable qui fait référence à l’objet doit se voir attribuer un objet existant à l’aide de l’instruction Set avant de pouvoir l’utiliser. Tant qu’un objet n’est pas affecté, la variable objet déclarée a la valeur spéciale Nothing, ce qui indique qu’elle ne fait référence à aucune instance particulière d’un objet.
Si vous ne spécifiez pas de type de données ou d’objet et qu’il n’y a pas d’instruction Deftype dans le module, la variable est Variant par défaut.
Vous pouvez également utiliser l’instruction Private suivie de parenthèses vides pour déclarer un tableau dynamique. Après avoir déclaré un tableau dynamique, utilisez l’instruction ReDim dans une procédure pour définir le nombre de dimensions et d’éléments dans le tableau. Si vous essayez de redéclarer une dimension pour une variable de tableau dont la taille a été explicitement spécifiée dans une instruction Private, Public ou Dim , une erreur se produit.
Lorsque les variables sont initialisées, une variable numérique est initialisée à 0, une chaîne de longueur variable est initialisée à une chaîne vide ("") et une chaîne de longueur fixe est remplie de zéros. Les variables de type Variant sont initialisées à la valeur Empty. Chaque élément d'une variable de type défini par l'utilisateur est initialisé comme s'il s'agissait d'une variable distincte.
Remarque
L’instruction Private ne peut pas être utilisée à l’intérieur d’une procédure ; utilisez l’instruction Dim pour déclarer des variables locales.
Exemple
Cet exemple montre l’instruction Private telle qu’elle est utilisée au niveau du module pour déclarer des variables comme étant privées ; c’est-à-dire disponibles uniquement au module dans lequel elles sont déclarées.
Private Number As Integer ' Private Integer variable.
Private NameArray(1 To 5) As String ' Private array variable.
' Multiple declarations, two Variants and one Integer, all Private.
Private MyVar, YourVar, ThisVar As Integer
Voir aussi
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.