Option Explicit (Instrucción, Visual Basic)

Artículo
06/08/2015

Fuerza la declaración explícita de todas las variables de un archivo, o permite declaraciones implícitas de variables.

Option Explicit { On | Off }

Elementos

On
Opcional. Habilita la comprobación Option Explicit. Si no se especifica On u Off, el valor predeterminado es On.
Off
Opcional. Deshabilita la comprobación Option Explicit.

Comentarios

Cuando Option Explicit On o Option Explicit aparece en un archivo, se deben declarar explícitamente todas las variables mediante las instrucciones Dim o ReDim. Si intenta usar un nombre de variable no declarada, se producirá un error en tiempo de compilación. La instrucción Option Explicit Off permite la declaración implícita de variables.

Si se utiliza, la instrucción Option Explicit tiene que aparecer en un archivo antes que cualquier otra instrucción de código fuente.

Nota

Establecer Option Explicit en Off generalmente no es una buena práctica.Pudo escribir un nombre de variable incorrectamente en una o más ubicaciones, lo que podría causar resultados inesperados cuando se ejecute el programa.

Cuando no existe una instrucción Option Explicit

Si el código fuente no contiene una instrucción Option Explicit, se utiliza el valor de Option Explicit en Página Compilación, Diseñador de proyectos (Visual Basic) . Si se utiliza el compilador de línea de comandos, se utiliza la opción del compilador /optionexplicit.

Para establecer Option Explicit en el IDE

En el Explorador de soluciones, seleccione un proyecto. En el menú Proyecto, haga clic en Propiedades. Para obtener más información, vea Introducción al Diseñador de proyectos.
Haga clic en la ficha Compilar.
Establezca el valor en el cuadro Option Explicit.

Cuando se crea un nuevo proyecto, el valor de Option Explicit en la pestaña Compilación se establece en el valor de Option Explicit en el cuadro de diálogo Valores predeterminados de VB. Para obtener acceso al cuadro de diálogo Valores predeterminados de VB, en el menú Herramientas, haga clic en Opciones. En el cuadro de diálogo Opciones, expanda Proyectos y soluciones y, a continuación, haga clic en Valores predeterminados de VB. El valor predeterminado inicial de Valores predeterminados de VB es On.

Para establecer Option Explicit en la línea de comandos

Incluya la opción del compilador /optionexplicit en el comando vbc.

Ejemplo

En el ejemplo siguiente se utiliza la instrucción Option Explicit para exigir la declaración explícita de todas las variables. Si intenta utilizar una variable no declarada, se producirá un error en tiempo de compilación.

' 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