Option Explicit 语句 (Visual Basic)

项目
08/12/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 语句，则使用 “项目设计器”->“编译”页 (Visual Basic) 上的**“Option Explicit”**设置。如果使用命令行编译器，则使用 /optionexplicit 编译器选项。

在 IDE 中设置 Option Explicit

在**“解决方案资源管理器”中选择一个项目。在“项目”菜单上，单击“属性”**。有关更多信息，请参见项目设计器介绍。
单击**“编译”**选项卡。
在**“Option Explicit”**框中设置此值。

当您创建新项目时，编译选项卡上的**“Option Explicit”设置将在“VB 默认值”对话框中设为“Option Explicit”设置。若要访问“VB 默认值”对话框，请在“工具”菜单上，单击“选项”。在“选项”对话框中展开“项目和解决方案”，然后单击“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