Instrucción Option Explicit (Visual Basic)

Artículo
10/07/2008

Actualización: noviembre 2007

Exige la declaración explícita de todas las variables en un archivo.

Option Explicit { On | Off }

Partes

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

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

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

Utilice Option Explicit para evitar escribir incorrectamente el nombre de una variable existente o para evitar confusiones en el código allí donde el ámbito de la variable no esté claro. Si no utiliza la instrucción Option Explicit, todas las variables no declaradas son de tipo Object.

Nota:
El valor predeterminado del compilador es Option Explicit On si no especifica Option Explicit en el código.

También puede establecer Option Explicit en el entorno de desarrollo integrado (IDE) de Visual Studio o en una línea de comandos.

Nota:
Los cuadros de diálogo y los comandos de menú que se ven pueden diferir de los descritos en la Ayuda, dependiendo de los valores de configuración o de edición activos. Para cambiar su configuración, haga clic en Importar y exportar configuraciones en el menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio.

Para establecer Option Explicit en el IDE

En el menú Herramientas, haga clic en Opciones.
Abra el nodo Proyectos y soluciones.
Elija Valores predeterminados de VB.
Modifique el valor de Option Explicit.

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