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

另請參閱