Option Explicit, instruction (Visual Basic)

Article
09/12/2008

Mise à jour : novembre 2007

Force une déclaration explicite de toutes les variables dans un fichier.

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

Si elle est utilisée, l'instruction Option Explicit doit apparaître dans un fichier avant toute autre instruction de code source.

Si l'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.

Utilisez l'instruction Option Explicit pour éviter toute faute de frappe lors de la saisie du nom d'une variable existante ou pour écarter tout risque de confusion dans un code où la portée de la variable n'apparaît pas clairement. Si vous n'utilisez pas l'instruction Option Explicit, toutes les variables non déclarées prennent le type Object.

Remarque :
Si vous ne spécifiez pas Option Explicit dans votre code, le compilateur par défaut est Option Explicit On.

Vous pouvez également définir Option Explicit dans l'environnement de développement intégré (IDE) Visual Studio ou dans une ligne de commande.

Remarque :
Selon vos paramètres actifs ou votre édition, les boîtes de dialogue et les commandes de menu que vous voyez peuvent différer de celles qui sont décrites dans l'aide. Pour modifier vos paramètres, cliquez sur Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour définir Option Explicit dans l'IDE

Dans le menu Outils, cliquez sur Options.
Ouvrez le nœud Projets et Solutions.
Choisissez Valeurs par défaut VB.
Modifiez la propriété Option Explicit.

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