Share via


Option Explicit 陳述式 (Visual Basic)

強制明確宣告檔案中的所有變數,或者允許隱含宣告變數。

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

  1. 在 [方案總管] 中選取專案。 在 [專案] 功能表上,按一下 [屬性]。 如需詳細資訊,請參閱專案設計工具簡介

  2. 按一下 [編譯] 索引標籤。

  3. 設定 [Option Explicit] 方塊中的值。

當您建立新專案時,[編譯] 索引標籤上的 [Option Explicit] 會設定為 [VB 預設值] 對話方塊中的 [Option Explicit] 設定。 若要存取 [VB 預設值] 對話方塊,請在 [工具] 功能表中按一下 [選項]。 在 [選項] 對話方塊中,展開 [專案和方案],然後按一下 [VB 預設值]。 [VB 預設值] 中的初始預設設定是 On。

若要在命令列上設定 Option Explicit

範例

下列範例會使用 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

請參閱

參考

Dim 陳述式 (Visual Basic)

ReDim 陳述式 (Visual Basic)

Option Compare 陳述式

Option Strict 陳述式

/optioncompare

/optionexplicit

/optionstrict

選項對話方塊、專案、Visual Basic 預設值