Option Explicit, instruction (Visual Basic)
Force la déclaration explicite de toutes les variables dans un fichier ou autorise les déclarations implicites de variables.
Syntaxe
Option Explicit { On | Off }
Éléments
On
Optionnel. Active la vérification de Option Explicit
. Si On
ou Off
n’est pas spécifié, la valeur par défaut est de On
.
Off
Optionnel. Désactive la vérification de Option Explicit
.
Notes
Lorsque Option Explicit On
ou Option Explicit
s’affiche dans un fichier, vous devez déclarer explicitement toutes les variables à l’aide des instructions Dim
ou ReDim
. Si vous essayez d’utiliser un nom de variable non déclaré, une erreur se produit au moment de la compilation. L’instruction Option Explicit Off
autorise la déclaration implicite des variables.
Si elle est utilisée, l'instruction Option Explicit
doit apparaître dans un fichier avant toute autre instruction de code source.
Notes
Il n’est généralement pas recommandé d’affecter à Option Explicit
la valeur Off
. Vous risquez de mal orthographier un nom de variable dans un ou plusieurs emplacements, ce qui peut provoquer des résultats inattendus lors de l’exécution du programme.
En l’absence d’instruction Option Explicit
Si le code source ne contient pas d’instruction Option Explicit
, le paramètre Option Explicit sur la page de compilation, le Concepteur de projets (Visual Basic) est utilisé. Si le compilateur de ligne de commande est utilisé, l’option de compilateur -optionexplicit est utilisée.
Définir Option Explicit dans l’IDE
Dans l’Explorateur de solutions, sélectionnez un projet. Dans le menu Projet , cliquez sur Propriétés.
Cliquez sur l’onglet Compiler.
Définissez la valeur dans la zone Option Explicit.
Quand vous créez un projet, le paramètre Option Explicit de l’onglet Compiler reprend la définition du paramètre Option Explicit de la boîte de dialogue Valeurs par défaut VB. Pour accéder à la boîte de dialogue Valeurs par défaut VB, dans le menu Outils, cliquez sur Options. Dans la boîte de dialogue Options, développez Projets et solutions, puis cliquez sur Valeurs par défaut VB. La définition par défaut initiale de Valeurs par défaut VB est On
.
Définir Option Explicit sur la ligne de commande
- Incluez l’option du compilateur-optionexplicit dans la commande vbc.
Exemple
L’exemple suivant utilise l’instruction Option Explicit
pour forcer la déclaration explicite de toutes les variables. La tentative d’utilisation d’une variable non déclarée génère une erreur au moment de la compilation.
' Force explicit variable declaration.
Option Explicit On
Dim thisVar As Integer
thisVar = 10
' The following assignment produces a COMPILER ERROR because
' the variable is not declared and Option Explicit is On.
thisInt = 10 ' causes ERROR