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

  1. Dans l’Explorateur de solutions, sélectionnez un projet. Dans le menu Projet , cliquez sur Propriétés.

  2. Cliquez sur l’onglet Compiler.

  3. 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

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

Voir aussi