參考和 Imports 陳述式 (Visual Basic)

您可以選擇 [專案] 功能表上的 [新增參考] 命令,使外部物件可供您的專案使用。 Visual Basic 中的參考可以指向類似類型程式庫但包含詳細資訊的組件。

Imports 陳述式

組件包含一或多個命名空間。 當您將參考新增至組件時,也可以將 Imports 陳述式新增至模組,以控制該組件命名空間在模組內的可見度。 Imports 陳述式提供範圍內容,讓您僅使用提供唯一參考所需的命名空間部分。

Imports 陳述式具有下列語法:

Imports [Aliasname =] Namespace

Aliasname 是指您可在程式碼內用來參考匯入命名空間的簡短名稱。 Namespace 是一個命名空間,可透過專案參考、透過專案內的定義,或透過先前的 Imports 陳述式取得。

模組可包含任意數目的 Imports 陳述式。 其必須出現在任何 Option 陳述式之後 (如果有),但必須出現在任何其他程式碼之前。

注意

請勿將專案參考與 Imports 陳述式或 Declare 陳述式混淆。 專案參考可讓 Visual Basic 專案使用外部物件 (例如組件中的物件)。 Imports 陳述式可用來簡化專案參考的存取,但不會提供這些物件的存取權。 Declare 陳述式可用來宣告動態連結程式庫 (DLL) 中對外部程序的參考。

搭配 Imports 陳述式使用別名

Imports 陳述式不需要明確輸入參考的完整名稱,可讓您更輕鬆地存取類別的方法。 別名可讓您將較易記的名稱指派給命名空間的其中一個部分。 例如,導致在多行上顯示單一文字片段的歸位字元/換行字元序列是 Microsoft.VisualBasic 命名空間中 ControlChars 模組的一部分。 若要在沒有別名的程式中使用這個常數,您就必須輸入下列程式碼:

MsgBox("Some text" & Microsoft.VisualBasic.ControlChars.CrLf &
       "Some more text")

Imports 陳述式一律必須是緊接在模組中任何 Option 陳述式後面的第一行。 下列程式碼片段示範如何匯入別名並將別名指派給 Microsoft.VisualBasic.ControlChars 模組:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

此命名空間的參考未來可能會大幅縮短:

MsgBox("Some text" & CtrlChrs.CrLf & "Some more text")

如果 Imports 陳述式不包含別名名稱,則不需要限定性條件,即可在模組中使用匯入命名空間內定義的元素。 如果指定別名名稱,則必須將其做為該命名空間內所含名稱的限定詞。

另請參閱