如何在 Visual Basic for Applications 中使用 Excel 子程序中的變數

簡介

本文說明如何在 VBA) 的 Visual Basic for Applications (Excel 子程序中宣告和使用變數,包括變數範圍和存留期。

子程序中的變數

變數會儲存在 VBA 程式碼執行時可以使用或變更的值。 本文說明:

  • 如何宣告變數。
  • 變數範圍如何決定變數的使用位置。
  • 變數保留其值的時間長度。

宣告巨集中的變數

使用 Dim 陳述式在巨集中宣告變數。 下列範例會將兩個變數宣告為 Integer:

    Dim x As Integer, y As Integer

因為這兩個變數都宣告為 整數, x 而且 y 可以儲存 -32,768 到 32,767 之間的整數。

注意

當您在一個 Dim 陳述式中宣告多個變數時,請指定每個變數的資料類型。

如果未指定每個變數的資料類型,則只有緊接在後面的 As Integer 變數會宣告為 Integer。 在下列範例中, x 是 Variant ,且 y 是 整數:

    Dim x, y As Integer

如需詳細資訊,請參閱下方的 VARIANT 資料型別 一節。

若要執行變數檢定:

  1. 在 Excel 中開啟活頁簿。

  2. 按 Alt+F11 開啟 Visual Basic 編輯器。

  3. 在 [插入] 功能表中,選取 [模組]。

  4. 輸入下列程式碼:

    Sub Variable_Test()
        Dim x As Integer,y As Integer
        x = 10
        y = 100
        MsgBox “the value of x is ” & x & _
        Chr (13) & “y 的值是” & y
    End Sub

  5. 執行 Variable_Test 巨集。 您會收到下列訊息:

    the value of x is 10
    the value of y is 100

  6. 選取 [確定]。

  7. 在 Variable_Test 巨集中,變更下一行:

    x = 10

  8. 收件者:

    x = "error"

  9. 執行 Variable_Test 巨集。

執行階段錯誤之所以發生,是因為「錯誤」是字串值,無法將其指派給整 數 變數 x。

資料型別摘要

以下是常見的變數資料型別:

顯示常見變數資料類型的螢幕擷取畫面。

VARIANT 資料類型

如果您在宣告變數時未指定資料型別,或完全不宣告變數,則 Visual Basic 會自動將 Variant 資料型別指派給變數。 下列是宣告為此資料型別的變數的優點:

  • 變數可以包含字串、日期、時間、布林值或數值。
  • 變數可以自動轉換所包含的值。

若要在 Variable_Test 巨集中查看其運作方式:

將 Variable_Test 巨集中的程式碼變更為:


Sub Variable_Test()
    Dim x, y
    x = "string"
    y = 1.23
    MsgBox "the value of x is " & x & _
    Chr(13) & "the value of y is " & y
End Sub

執行 Variable_Test 巨集。

巨集執行時不會出現類型不符的情況,因為 x 和 y 是 變體 變數,而且可以包含不同類型的資料。

變數的範圍

變數的範圍決定它能在 VBA 專案中使用的位置。 變數可以有程序層級、私人模組層級或公用模組層級範圍,視其宣告位置和方式而定。

程序-層級範圍

程序層級變數只能在宣告它的程序內使用。 其他程序無法存取其值。

若要確認在宣告程序之外看不到具有程序層級範圍的變數:

  1. 在專案中插入新模組。

  2. 在此模組中輸入下列兩個巨集:
      Sub Macro1 () Dim x As Integer x = 10 MsgBox “x,如 Macro1 所示是” & x '下一行執行 Macro2 Macro2 End Sub Sub Macro2 () MsgBox “x,如 Macro2 所示是” & x End Sub

  3. 執行 Macro1,您會收到下列訊息:

    x, as seen by Macro1 is 10

  4. 選取 [確定],您會收到下列訊息:

    x, as seen by Macro2 is

  5. 選取 [確定]。

Macro2 不顯示變數 x 的值,因為變數 x 是局部的 Macro1。

私人和公用模組-層級範圍

您可以在模組頂端的 [宣告] 區段中,在任何程序之前宣告變數。 使用 [公開 ] 可讓變數可供整個專案的程序使用。 在模組層級使用 Dim 或 Private ,讓變數僅可供該模組中的程序使用。

若要查看 公開 陳述式與 Dim 陳述式之間的差異:

  1. 儲存並關閉任何開啟的活頁簿,然後開啟新的活頁簿。

  2. 啟動 [Visual Basic 編輯器]。

  3. 在專案中插入模組。

  4. 在新模組中輸入下列程式碼:

    Public x As Integer Sub Macro_1a () x = 10 MsgBox x Macro_1b End Sub Sub Macro_1b () x = x * 2 MsgBox x Macro2 End Sub

    
    
  5. 在專案中插入另一個模組。

  6. 在新模組中輸入下列程式碼:
    Sub Macro2()
        x = x * 3
        MsgBox x
    End Sub

  7. 在第一個模組中執行 Macro_1a 巨集。

  8. 當變數 x 宣告為 Public x As Integer時,專案中的所有三個巨集都可存取 的值 x。 第一個訊息框會顯示值為 10。 第二個消息框會顯示值為 20 (x 因為乘以 2 in Macro_1b) 。 第三個訊息框會顯示值為 60 (,因為 的 x 值已變更為 20 in Macro_1b ,然後乘以 3 in Macro2) 。

  9. 將第一個模組中的宣告行從:

    Public x As Integer

    收件者:

    Dim x As Integer

  10. 執行 Macro_1a 巨集。

  11. 當變數 x 宣告為 Dim x As Integer時,只有第一個模組中的巨集可以使用 的 x值。 因此,第一個訊息框會顯示值為 10,第二個消息框會顯示值為 20 (,因為 x 乘以 2 in Macro_1b) ,而第三個消息框會顯示值為 0 (,因為 Macro2 看不到的 x 值,並使用未初始化的零) 值。

  12. 將第一個模組中的宣告行從:

    Dim x As Integer

    收件者:

     Private x As Integer

  13. 執行 Macro_1a 巨集。

  14. 當您使用 私人 陳述式時,所顯示的訊息框與使用 Dim 陳述式時相同。 變數 x 具有相同的範圍:它是宣告它的模組的私用。

秘訣

在模組層級, Dim 和 Private 會為變數提供相同的範圍。 當您想要明確預期的範圍時,請使用 私人 。

變數的存留期

變數的存留期是保留值的期間。 當變數失去範圍時,它就不再有值。

將變數值初始化

程序啟動時,會初始化其變數。 數值變數會初始化為零,可變數長度字串會初始化為零長度字串 (“) 、固定長度字串以 ASCII 字元代碼 0 表示,而 變體 變數則會初始化為空白。 空白 變體 在數值內容中會以零表示,在字串內容中則表示為長度為零的字串。

程序-層級變數

以 Dim 宣告的程序層級變數會保留其值,直到程序完成執行為止。 如果程序呼叫另一個程序,變數會在呼叫程序執行時保留其值,但呼叫程序無法使用。

示範程序層級變數的運作方式:

  1. 在專案中插入新模組。

  2. 在此模組中輸入下列兩個巨集:

    Sub Macro1()
        '將 x 設定為程序層級變數
       Dim x As Integer
       MsgBox “x 的初始化值為” & x
       x = 10
        MsgBox “x is” & x
        '下一行執行 Macro2
        Macro2
        MsgBox “x 仍是” & x
    End Sub
    Sub Macro2 ()
        MsgBox “x,如 Macro2 所示是” & x
    End Sub

  3. 執行巨集 1。

  4. 您會收到下列訊息:

        the initialized value of x is 0

  5. 選取 [確定],您會收到訊息:

     x is 10

  6. 選取 [確定],您會收到下列訊息:

    x, as seen by Macro2 is

  7. 選取 [確定]。

  8. Macro2 不顯示變數 x 的值,因為變數 x 是局部的 Macro1。 您會收到下列訊息:

    x is still 10

  9. 選取 [確定]。

  10. 執行 巨集 1。

執行完畢時 Macro1 ,程序層級變數 x 的值會遺失。 因此,當您再次執行 Macro1 時, x ,會初始化為零。

靜態關鍵字

如果程序層級變數是使用 Static 關鍵字來宣告,只要程式碼在執行,變數就會保留其值。 因此,如果您有靜態變數,下次呼叫程序時,靜態變數會初始化為最後一個值。

若要查看 Static 關鍵字的運作方式:

  1. 將 Macro1 中的程式碼變更為:

    Sub Macro1 () 'set x as a procedure-level variable Static x As Integer MsgBox “x 的初始化值為” & x x = x + 10 MsgBox “x is ” & x End Sub

    
    
  2. 執行巨集 1。

  3. 您會收到訊息:

    the initialized value of x is 0

  4. 選取 [確定],您會收到訊息:

    x is 10

  5. 選取 [確定]。

  6. 執行 Macro1,您會收到下列訊息:

    the initialized value of x is 10

  7. 選取 [確定],您會收到下列訊息:

    x is 20

  8. 選取 [確定]。

第二次出現在訊息中的值會不同,因為變數 x 會宣告為靜態變數,而變數會在您第一次執行 Macro1 後保留其值。

注意

模組層級變數和靜態程序層級變數具有類似的存留期,但它們的範圍不同。

若要驗證模組層級變數的存留期:

  1. 將模組中包含 Macro1 的程式碼變更為下列內容:

    Dim x As Integer '建立模組層級變數 Sub Macro1 () MsgBox “x 的初始化值為” & x x = x + 10 MsgBox “x is ” & x End Sub

    
    
  2. 執行 Macro1,您會收到下列訊息:

    the initialized value of x is 0

  3. 選取 [確定],您會收到下列訊息:

    x is 10

  4. 選取 [確定]。

  5. 執行 Macro1,您會收到此訊息:

    the initialized value of x is 10

  6. 選取 [確定]。

  7. 您會收到下列訊息:

    x is 20

  8. 選取 [確定]。

第二次出現在訊息中的值會不同,因為它 x 宣告為模組層級變數,並在您第一次執行 Macro1 後保留其值。

重設專案以重設變數

若要重設靜態和模組層級變數,請在 Visual Basic 編輯器中重設 VBA 專案。

如果您對 Macro1 專案執行此動作,然後重新執行 Macro1,則變數 x 的值會初始化回零,且您會收到第一則訊息:

the initialized value of x is 0