Instrução Option Explicit (Visual Basic)
Força a declaração explícita de todas as variáveis em um arquivo ou permite declarações implícitas de variáveis.
Sintaxe
Option Explicit { On | Off }
Partes
On
Opcional. Habilita a verificação Option Explicit. Se On ou Off não for especificado, o padrão será On.
Off
Opcional. Desabilita a verificação de Option Explicit.
Comentários
Quando Option Explicit On ou Option Explicit aparece em um arquivo, você precisa declarar explicitamente todas as variáveis usando a instrução Dim ou ReDim. Se você tentar usar um nome de variável não declarado, ocorrerá um erro em tempo de compilação. A instrução Option Explicit Off permite a declaração implícita de variáveis.
Se usado, a instrução Option Explicit deve aparecer em um arquivo antes de quaisquer outras instruções de código-fonte.
Observação
Configurar Option Explicit como Off geralmente não é uma boa prática. Você poderia digitar incorretamente um nome de variável em um ou mais locais, o que levaria a resultados inesperados na execução do programa.
Quando uma instrução Option Explicit não está presente
Se o código-fonte não contiver uma instrução Option Explicit, será usada a configuração de Option Explicit em Compilar Página, Designer de Projeto (Visual Basic). Se for usado o compilador de linha de comando, será usada a opção do compilador -optionexplicit.
Para definir Option Explicit no IDE
No Gerenciador de Soluções, selecione um projeto. No menu Projeto , clique em Propriedades.
Clique na guia Compilar.
Defina o valor na caixa Option Explicit.
Quando você cria um novo projeto, a configuração de Option Explicit na guia Compilar é definida para a configuração de Option Explicit na caixa de diálogo Padrões do VB. Para acessar a caixa de diálogo Padrões do VB, no menu Ferramentas, clique em Opções. Na caixa de diálogo Opções, expanda Projetos e Soluções e, em seguida, clique em Padrões de VB. A configuração inicial padrão nos Padrões do VB é On.
Para definir Option Explicit na linha de comando
- Inclua a opção -optionexplicit do compilador no comando vbc.
Exemplo
O exemplo a seguir usa a instrução Option Explicit para forçar a declaração explícita de todas as variáveis. Tentar usar uma variável não declarada causa um erro em tempo de compilação.
' 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
