Partilhar via

Declaração explícita de opção (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. Permite Option Explicit a verificação. Se On ou Off não for especificado, o padrão é On.

Off
Opcional. Desabilita a Option Explicit verificação.

Observações

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

Se usada, a Option Explicit instrução deve aparecer em um arquivo antes de qualquer outra instrução de código-fonte.

Nota

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

Quando uma instrução explícita de opção não está presente

Se o código-fonte não contiver uma Option Explicit instrução, a configuração Opção explícita na página de compilação, Project Designer (Visual Basic) será usada. Se o compilador de linha de comando for usado, a opção de compilador -optionexplicit será usada.

Para definir a opção explícita 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 Opção explícita .

Quando você cria um novo projeto, a configuração Opção explícita na guia Compilar é definida como a configuração Opção explícita na caixa de diálogo Padrões 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 clique em Padrões VB. A configuração padrão inicial em VB Defaults é On.

Para definir a opção explícita na linha de comando

Exemplo

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