DIM |
Dimensionne |
---|---|
Visual Basic |
Syntaxe
DIM tableau(subscripts),tableau(subscripts),... |
DIM tableau[([subscripts])][As [New] type][, tableau[([subscripts])][As [New] type]] . . . |
DIM variable AS Boolean |
DIM variable AS Byte |
DIM variable AS Currency |
DIM variable AS Date |
DIM variable AS Double |
DIM variable AS Integer |
DIM variable AS Long |
DIM variable AS Single |
DIM variable AS String |
Paramètres
Nom | Description |
---|---|
subscripts | Ce paramètre permet d'indiquer les dimensions d'une variable de tableau; jusqu'à 60 dimensions multiples peuvent être déclarées. |
tableau | Ce paramètre permet d'indiquer le nom du tableau à créer. Le nom doit suivre les conventions de dénomination des variables standard. |
variable | Ce paramètre permet le nom de la variable dont vous souhaitez attribué un type. Le nom doit suivre les conventions de dénomination des variables standard. |
type | Ce paramètre permet d'indiquer le type de données de la variable; peut être Byte, Boolean, Integer, Long, Currency, Single, Double, Date, String (pour les chaînes de caractères de longueur variable), String * longueur(pour les chaînes de longueur fixe), Object, Variant, un type défini par l'utilisateur ou un type d'objet. Utilisez une clause de «As type» distincte pour chaque variable que vous déclarez. |
New | Ce paramètre permet d'indiquer qu'une variable d'objet déclarée est une nouvelle instance d'un objet Visual Basic ou d'un objet OLE Automation pouvant être créé en externe. Le mot clef New ne peut pas être utilisé pour déclarer des variables d'un type de données intrinsèque et ne peut pas être utilisé pour déclarer des instances d'objets OLE Automation dépendants. |
Description
Cette commande permet de définir un ou des tableau(x) ou variable(s).
Remarques
- Le paramètre subscripts utilise la syntaxe suivante :
- Les variables déclarées avec Dim au niveau du module sont disponibles pour toutes les procédures du module. Au niveau de la procédure, les variables ne sont disponibles que dans la procédure.
Utilisez l'instruction Dim au niveau du module ou de la procédure pour déclarer le type de données d'une variable. Par exemple, l'instruction suivante déclare une variable comme un entier :
Dim NumberOfEmployees As Integer
Utilisez également une instruction Dim pour déclarer le type d'objet d'une variable. Ce qui suit déclare une variable pour une nouvelle instance d'une Worksheet :
Dim X As New Worksheet
- Si le mot clef New n'est pas utilisé lors de la déclaration d'une variable d'objet, aucune instance de l'objet n'existe réellement. Une variable faisant référence à un objet doit se voir affecter un objet existant à l'aide de l'instruction Set avant de pouvoir être utilisée. Jusqu'à ce qu'un objet lui soit affecté, la variable objet déclarée a la valeur spéciale Nothing, indiquant qu'elle ne fait référence à aucune instance particulière d'un objet.
- Vous pouvez également utiliser l'instruction Dim avec des 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.
- 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.
- Lorsque les variables sont initialisées, une variable numérique est initialisée à 0, une chaîne de caractères de longueur variable est initialisée à une chaîne de caractères de longueur 0 et une chaîne de caractères de longueur fixe est remplie de zéros. Les variables Variant sont initialisées à 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.
- Lorsque vous utilisez l'instruction Dim dans une procédure, il est généralement admis de mettre l'instruction Dim au début de la procédure.
[lower To] upper [,[lower To] upper] . . . |
Lorsqu'elle n'est pas explicitement indiquée en bas, la limite inférieure d'un tableau est contrôlée par l'instruction Option Base. La limite inférieure est zéro si aucune instruction Option Base n'est présente.
Exemple
Voici un exemple d'une utilisation typique de cette commande :
Dernière mise à jour : Lundi, le 19 novembre 2012