Compartilhar via


Instrução Option Explicit (Visual Basic)

Força a declaração explícita de todas as variáveis em um arquivo ou permite que as declarações implícitas de variáveis.

Option Explicit { On | Off }

Partes

  • On
    Opcional. Permite verificação Option Explicit. Se On ou Off não for especificado, o padrão é On.

  • Off
    Opcional. Desativa verificação Option Explicit.

Comentários

Quando Option Explicit On ou Option Explicit aparece em um arquivo, você deve declarar explicitamente todas as variáveis usando a Dim ou ReDim instruções. Se você tentar usar um nome de variável não declarado, ocorrerá um erro em tempo de compilação. O Option Explicit Off instrução permite que a declaração implícita de variáveis.

Se usada, a declaração Option Explicit deve aparecer em um arquivo antes de quaisquer outras declarações no código-fonte.

Dica

Definindo Option Explicit para Off não é geralmente uma boa prática.Você poderia digitar incorretamente um nome de variável em um ou mais locais, o que poderia causar resultados inesperados quando o programa é executado.

Quando não está presente de uma instrução Option Explicit

Se o código-fonte não contém um Option Explicit instrução, o Option Explicit definição na Página de Compilação, Designer de Projeto (Visual Basic) é usado. Se o compilador de linha de comando for usado, o /optionexplicit opção de compilador é usada.

Para definir Option Explicit no IDE

  1. Em Solution Explorer, selecione um projeto. No menu Project, clique em Properties.. Para obter mais informações, consulte Introdução ao Project Designer.

  2. Clique na guia Compile.

  3. Defina o valor no Option Explicit caixa.

Quando você cria um novo projeto, o Option Explicit definição na Compilar for definido como o Option Explicit definição na Padrões de VB caixa de diálogo. Para acesso a Padrões de VB caixa de diálogo, diante a Ferramentas menu, clique em Opções. No Opções caixa de diálogo caixa, expanda projetos e soluçõese, em seguida, clique em Padrões de VB. A configuração padrão inicial no Padrões de VB é On.

Para definir Option Explicit na linha de comando

Exemplo

O exemplo a seguir usa a Option Explicit a instrução para forçar uma declaração explícita de todas as variáveis. Tentando 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

Consulte também

Referência

Instrução Dim (Visual Basic)

Instrução ReDim (Visual Basic)

Instrução Option Compare

Instrução Option Strict

/optioncompare

/optionexplicit

/optionstrict

Caixa de diálogo Padrões do Visual Basic, Projetos, Opções