DIM |
Dimensionne |
|---|---|
| VB .NET (Visual Basic .NET) | |
Syntaxe
| DIM tableau(longueur),tableau(longueur),... |
| DIM tableau(longueur) As ...,... |
| 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 |
| DIM variable AS Variant |
| DIM variable AS Currency |
Paramètres
| Nom | Description |
|---|---|
| tableau | Ce paramètre permet d'indiquer le tableau à créer |
| longueur | Ce paramètre permet d'indiquer le nombre d'élément que doit contenir le tableau |
| variable | Ce paramètre permet le nom de la variable dont vous souhaitez attribué un type |
Description
Cette commande permet de définir un ou des tableau(x) ou variable(s).
Remarques
- Le compilateur Visual Basic .NET utilise l'instruction Dim pour déterminer le type de données de la variable et d'autres informations, telles que le code pouvant accéder à la variable.
- Avec l'instruction DIM, vous pouvez spécifier n'importe quel type de données ou le nom d'une énumération, d'une structure, d'une classe ou d'une interface.
- Pour un type référence, vous utilisez le mot clef New pour créer une nouvelle instance de la classe ou de la structure spécifiée par le type de données. Si vous utilisez New, vous n'utilisez pas d'expression d'initialisation. Au lieu de cela, vous fournissez des paramètres, s'ils sont requis, au constructeur de la classe à partir de laquelle vous créez la variable.
- Vous pouvez déclarer une variable dans une procédure, un bloc, une classe, une structure ou un module. Vous ne pouvez pas déclarer une variable dans un fichier source, un espace de noms ou une interface.
- Une variable déclarée au niveau du module, en dehors de toute procédure, est une variable membre ou un champ. Les variables membres sont dans la portée dans toute leur classe, structure ou module. Une variable déclarée au niveau de la procédure est une variable locale. Les variables locales ne sont dans la portée que dans leur procédure ou leur bloc.
- Les modificateurs d'accès suivants sont utilisés pour déclarer des variables en dehors d'une procédure : Public, Protected, Friend, Protected Friend et Private.
- Le mot clef Dim est facultatif et généralement omis si vous spécifiez l'un des modificateurs suivants : Public, Protected, Friend, Protected Friend, Private, Shared, Shadows, Static, ReadOnly ou WithEvents.
- Si Option Explicit est activé (valeur par défaut), le compilateur requiert une déclaration pour chaque variable que vous utilisez.
- Spécification d'une valeur initiale : Vous pouvez affecter une valeur à une variable lors de sa création. Pour un type valeur, vous utilisez un initialiseur pour fournir une expression à affecter à la variable. L'expression doit évaluer une constante pouvant être calculée au moment de la compilation. Si un initialiseur est spécifié et qu'un type de données n'est pas spécifié dans une clause As, l'inférence de type est utilisée pour déduire le type de données à partir de l'initialiseur.
- Déclaration de plusieurs variables : Vous pouvez déclarer plusieurs variables dans une instruction de déclaration, en spécifiant le nom de la variable pour chacune et en faisant suivre chaque nom de tableau de parenthèses. Plusieurs variables sont séparées par des virgules. Si vous déclarez plusieurs variables avec une clause As, vous ne pouvez pas fournir un initialiseur pour ce groupe de variables.
- Tableaux : Vous pouvez déclarer une variable pour contenir un tableau, pouvant contenir plusieurs valeurs. Pour spécifier qu'une variable contient un tableau, faites immédiatement suivre son nom de variable par des parenthèses. Vous pouvez spécifier les limites inférieure et supérieure de chaque dimension d'un tableau. Pour ce faire, incluez une liste de limites entre parenthèses. Pour chaque dimension, la liste des limites spécifie la limite supérieure et éventuellement la limite inférieure. La borne inférieure est toujours zéro, que vous la spécifiez ou non. Chaque indice peut varier de zéro à sa valeur limite supérieure.
- Durée de vie des variables locales statiques : Une variable locale statique a une durée de vie plus longue que celle de la procédure dans laquelle elle est déclarée. Les limites de la durée de vie de la variable dépendent de l'endroit où la procédure est déclarée et si elle est partagée.
- Attributs et modificateurs : Vous pouvez appliquer des attributs uniquement aux variables membres, pas aux variables locales. Un attribut fournit des informations aux métadonnées de l'assembly, ce qui n'est pas significatif pour l'entreposage temporaire tel que les variables locales. Au niveau du module, vous ne pouvez pas utiliser le modificateur Static pour déclarer des variables membres. Au niveau de la procédure, vous ne pouvez pas utiliser Shared, Shadows, ReadOnly, WithEvents ou tout autre modificateur d'accès pour déclarer des variables locales. Vous pouvez spécifier quel code peut accéder à une variable en fournissant un modificateur d'accès. Les variables membres de classe et de module (en dehors de toute procédure) sont par défaut en accès privé et les variables membres de structure par défaut en accès public. Vous pouvez ajuster leurs niveaux d'accès avec les modificateurs d'accès. Vous ne pouvez pas utiliser de modificateurs d'accès sur les variables locales (à l'intérieur d'une procédure). Vous pouvez spécifier WithEvents uniquement sur les variables membres, pas sur les variables locales à l'intérieur d'une procédure. Si vous spécifiez WithEvents, le type de données de la variable doit être un type de classe spécifique, et non Object. Vous ne pouvez pas déclarer un tableau avec WithEvents.
- Libérer les ressources gérées : Le ramasse-miettes du cadre d'application .NET élimine les ressources managées sans aucun codage supplémentaire de votre part. Cependant, vous pouvez forcer la suppression d'une ressource gérée au lieu d'attendre le ramasse-miettes. Si une classe conserve une ressource particulièrement précieuse et rare (telle qu'une connexion à une base de données ou un descripteur de fichier), vous ne voudrez peut-être pas attendre le prochain ramasse-miettes pour nettoyer une instance de classe n'étant plus utilisée. Une classe peut implémenter l'interface IDisposable pour fournir un moyen de libérer des ressources avant un ramasse-miettes. Une classe mettant en oeuvre cette interface expose une méthode Dispose pouvant être appelée pour forcer la libération immédiate de ressources précieuses. L'instruction Using automatise le processus d'acquisition d'une ressource, d'exécution d'un ensemble d'instructions, puis de suppression de la ressource. Cependant, la ressource doit mettre en oeuvre l'interface IDisposable.
Exemple
Voici un exemple d'une utilisation typique de cette commande :
Dernière mise à jour : Dimanche, le 9 novembre 2014