Compartilhar via

Instrução Option Explicit (Visual Basic)

  • Artigo

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

  1. No Gerenciador de Soluções, selecione um projeto. No menu Projeto , clique em Propriedades.

  2. Clique na guia Compilar.

  3. 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

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

Confira também