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

Статья
08/11/2011

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

Option Explicit { On | Off }

Части

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

Заметки

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

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

Примечание

Установка значения параметра Option Explicit равным Off как правило не является хорошей практикой.Могла произойти ошибка в имя переменной в одной или нескольких местах, что приведет к непредвиденным результатам при запуске программы.

При отсутствии оператора Option Explicit

Если исходный код не содержит операторOption Explicit , используется параметрOption Explicit Страница "Компиляция" в конструкторе проектов (Visual Basic) . Если используется компилятор в командной строке, то используется параметр компилятора /optionexplicit.

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

Выберите проект в Обозревателе решений. Выберите пункт Свойства в меню Проект. Дополнительные сведения см. в разделе Знакомство с конструктором проектов.
Перейдите на вкладку Compile.
Задайте значение в поле Option Explicit.

При создании нового проекта параметр Option Explicit на вкладкекомпилировать устанавливается для параметраOption Explicit в диалоговом окне умолчания VB. Чтобы открыть диалоговое окно Параметры Visual Basic по умолчанию, в меню Сервис выберите команду Параметры. В диалоговом окне Параметры разверните узел Проекты и решения и выберите пункт Параметры VB по умолчанию. Исходный параметр по умолчанию вПараметры VB по умолчанию - On.

Установка режима 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