Оператор Option Explicit (Visual Basic)

Статья
11/05/2008

Обновлен: Ноябрь 2007

Требует явного объявления всех переменных в файле.

Option Explicit { On | Off }

Компоненты

On
Необязательный компонент. Включает проверку Option Explicit. Если параметры On и Off не указаны, то по умолчанию используется параметр On.
Off
Необязательный компонент. Отключает проверку Option Explicit.

Заметки

При использовании оператор Option Explicit должен находиться перед всеми остальными операторами исходного кода.

При использовании в файле Option Explicit необходимо явно объявлять все переменные с помощью инструкций Dim или ReDim. Если попытаться использовать имя необъявленной переменной, то возникает ошибка времени компиляции.

Используйте оператор Option Explicit, чтобы избежать ошибок при наборе имен существующих переменных или исключить путаницу в коде в случае, когда у вас нет ясного представления об области действия переменных. Если оператор Option Explicit не используется, все необъявленные переменные имеют тип Object.

Примечание.
Если в коде не используется оператор Option Explicit, то компилятор по умолчанию использует режим Option Explicit On.

Режим Option Explicit можно установить и в интегрированной среде разработки (IDE) Visual Studio, а также в командной строке.

Примечание.
Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от действующих параметров или используемого выпуска. Чтобы изменить параметры, выберите пункт Импорт и экспорт параметров в меню Сервис. Дополнительные сведения см. в разделе Параметры Visual Studio.

Отображаемые диалоговые окна и команды меню могут отличаться от описанных в справке в зависимости от действующих параметров или используемого выпуска. Чтобы изменить параметры, выберите пункт Импорт и экспорт параметров в меню Сервис. Дополнительные сведения см. в разделе Параметры Visual Studio.

Установка режиме Option Explicit через интерфейс IDE

В меню Сервис выберите пункт Параметры.
Откройте узел Проекты и решения.
Выберите Параметры Visual Basic по умолчанию.
Измените параметр Option Explicit.

Установка режима Option Explicit из командной строки

Включите параметр компилятора /optionexplicit в команду vbc.

Пример

В этом примере показано применение оператора Option Explicit для включения обязательного объявления всех переменных. Попытка использования необъявленных переменных приводит к появлению ошибки времени компиляции.

' 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