Imports 陳述式 (.NET 命名空間和型別)

更新：2007 年 11 月

匯入在目前專案或所參考的專案和組件中定義的命名空間 (Namespace) 或程式設計項目。

Imports [ aliasname = ] namespace
-or-
Imports [ aliasname = ] namespace.element

參數

每個原始程式檔 (Source File) 都能包含任何數目的 Imports 陳述式。這些陳述式必須在選項宣告之後 (例如 Option Strict 陳述式)，而且它們必須在任何程式設計項目宣告之前 (例如 Module 或 Class 陳述式)。

您只能在檔案層級中使用 Imports。這表示匯入的宣告內容必須是原始程式檔，而且不能是命名空間、類別、結構、模組、介面、程序或區塊。

當您需要使用在一個或多個命名空間內宣告且具有相同名稱的項目時，匯入別名將會很有用。如需詳細資訊和範例，請參閱當多個變數擁有相同名稱時解析參考中「具有相同名稱的類別」的內容。

請注意，Imports 陳述式無法讓您的專案使用其他專案和組件中的項目。匯入不會取代設定參考的功能。它只是不再需要限定專案已經可以使用的名稱。如需詳細資訊，請參閱當多個變數擁有相同名稱時解析參考中「匯入包含的項目」的內容。

注意事項：
雖然用來宣告匯入別名的語法與用來匯入 XML 命名空間前置字元的語法類似，但結果卻不同。匯入別名可以做為程式碼中的運算式使用，但 XML 命名空間前置字元只能做為 XML 常值或 XML 軸屬性 (Property) 中的限定項目或屬性 (Attribute) 名稱前置字元使用。

別名：您不應該在模組層級以相同的名稱將成員宣告為 aliasname。如果您這樣做，Visual Basic 編譯器 (Compiler) 只會對宣告的成員使用 aliasname，而不再將它辨識為匯入別名。
命名空間名稱：您可以提供單一命名空間名稱或巢狀命名空間的字串。每個巢狀命名空間都會以句號 (.) 隔開下一個較高層級的命名空間，如下列範例所示。

Imports System.Collections.Generic
項目型別：如果您提供 element，它一定代表「容器項目」，也就是可以包含其他項目的程式設計項目。容器項目包含類別、結構、模組、介面和列舉型別 (Enumeration)。

範圍：要讓 Imports 陳述式使項目範圍變成可用的，需視您是否有指定 element 而定。如果您只指定 namespace，所有該命名空間唯一具名的成員及該命名空間中容器項目的成員，都可以在沒有限定性條件下使用。如果您指定 namespace 和 element，則只有該項目的成員可以在沒有限定性條件下使用。
限定性條件：命名空間或容器項目外的程式碼，通常必須使用該容器項目的命名空間名稱限定成員的名稱。除非專案具有同名之其他成員的存取權限，否則 Imports 陳述式會使這類限定性條件變成不必要。在這個情況下，您可以在每個 Imports 陳述式中指定 aliasname。然後只需要匯入別名，限定具有相同名稱的成員。

下列範例會匯入 Microsoft.VisualBasic.Strings 類別，並指派可用於存取 Left 方法的別名 str。

' Place Imports statements at the top of your program.
Imports str = Microsoft.VisualBasic.Strings

Class testClass1
    Sub showHello()
        ' Display only the word "Hello"
        MsgBox(str.Left("Hello World", 5))
    End Sub
End Class

請注意，先前範例會匯入 Microsoft 內之 VisualBasic 中的巢狀命名空間 Strings。當 MsgBox 函式 (Visual Basic) 存取 Left 方法時，它可以使用別名 str 而不使用這個限定字串 Microsoft.VisualBasic.Strings。