Option Explicit, instruction (Visual Basic)

Article
08/10/2011

Force la déclaration explicite de toutes les variables d'un fichier, ou permet les déclarations implicites de variables.

Option Explicit { On | Off }

Éléments

On
Facultatif. Active la vérification Option Explicit. Si On ou Off n'est pas spécifié, la valeur par défaut est On.
Off
Facultatif. Désactive la vérification Option Explicit.

Notes

Lorsque Option Explicit On ou Option Explicit apparaît dans un fichier, vous devez déclarer explicitement toutes les variables à l'aide des instructions Dim ou ReDim. Si vous tentez d'utiliser un nom de variable non déclarée, une erreur se produit au moment de la compilation. L'instruction Option Explicit Off permet une 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

Affecter à Option Explicit la valeur Off n'est pas une bonne pratique en général. 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.

Lorsqu'aucune instruction Option Explicit n'est présente

Si le code source ne contient pas d'instruction Option Explicit, le paramètre Option Explicit sur Page Compiler, Concepteur de projets (Visual Basic) est utilisé. Si le compilateur de ligne de commande est utilisé, l'option de compilateur /optionexplicit est utilisée.

Pour 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. Pour plus d'informations, consultez Introduction au Concepteur de projets.
Cliquez sur l'onglet Compiler.
Définissez la valeur dans la zone Option Explicit.

Lorsque vous créez un projet, le paramètre Option Explicit dans l'onglet Compiler correspond au paramètre Option Explicit dans la boîte de dialogue Valeurs par défaut VB. Pour accéder à la boîte de dialogue Valeurs par défaut VB, cliquez sur Options dans le menu Outils. Dans la boîte de dialogue Options, développez Projets et solutions, puis cliquez sur Valeurs par défaut VB. Le paramètre par défaut initial dans Valeurs par défaut VB est On.

Pour définir Option Explicit dans 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. Toute tentative d'utilisation d'une variable non déclarée se traduit par 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