已宣告之項目的參考 (Visual Basic)

發行項
08/12/2011

在程式碼參考宣告的項目時，Visual Basic 編譯器會將參考中的名稱對應至該名稱的適當宣告相符。如果有多個項目是利用相同的名稱宣告，您就可以透過「限定」(Qualifying) 名稱以控制所要參考的項目。

編譯器會嘗試使用「最窄範圍」(Narrowest Scope) 將名稱參考對應至名稱宣告。這代表編譯器會從使用參考的程式碼開始，依循包含項目的連續層級向外運作。

下列範例顯示對兩個具有相同名稱之變數的參考。這個範例中宣告兩個名為 totalCount 的變數，它們位於模組 container 中不同的範圍層級。當程序 showCount 以不限定名稱方式顯示 totalCount 時，Visual Basic 編譯器會將參考解析到具有最窄範圍的宣告，也就是 showCount 內的區域宣告。當以包含模組 container 限定 totalCount 時，編譯器會將參考解析到較廣範圍的宣告。

' Assume these two modules are both in the same assembly.
Module container
    Public totalCount As Integer = 1
    Public Sub showCount()
        Dim totalCount As Integer = 6000
        ' The following statement displays the local totalCount (6000).
        MsgBox("Unqualified totalCount is " & CStr(totalCount))
        ' The following statement displays the module's totalCount (1).
        MsgBox("container.totalCount is " & CStr(container.totalCount))
    End Sub
End Module
Module callingModule
    Public Sub displayCount()
        container.showCount()
        ' The following statement displays the containing module's totalCount (1).
        MsgBox("container.totalCount is " & CStr(container.totalCount))
    End Sub
End Module

限定項目名稱

如果要覆寫這個搜尋程序並指定較廣範圍中所宣告的名稱，則必須以較廣範圍的包含項目來「限定」(Qualify) 名稱。在某些情況下，您可能還必須限定包含項目。

限定名稱表示在來源陳述式中，該名稱的前面會加上識別定義目標項目的位置資訊。此資訊稱為「限定性條件字串」(Qualification String)。可包括一或多個命名空間 (Namespace) 和模組、類別或結構。

限定性條件字串應明確指定內含目標項目的模組、類別或結構。接著，容器 (Container) 可能會位在其他內含項目中，通常是命名空間。您可能需要在限定性條件字串中包括數個內含項目。

若要透過限定已宣告項目的名稱來存取該項目

判斷已在其中定義項目的位置。這可能包括命名空間，甚至是命名空間的階層架構。在最低層的命名空間內，項目必須包括在模組、類別或結構中。

' Assume the following hierarchy exists outside your code.
Namespace outerSpace
    Namespace innerSpace
        Module holdsTotals
            Public Structure totals
                Public thisTotal As Integer
                Public Shared grandTotal As Long
            End Structure
        End Module
    End Namespace
End Namespace

根據目標項目位置判斷限定性條件路徑。從最高層的命名空間開始，繼續到最低層的命名空間，並結束於內含目標項目的模組、類別或結構中。路徑中每個項目的後面都必須包含該項目。

outerSpace → innerSpace → holdsTotals → totals
準備目標項目的限定性條件字串。在路徑中的每個項目後面放上句號 (.)。應用程式必須具有限定性條件字串中每個項目的存取權。
```
outerSpace.innerSpace.holdsTotals.totals.
```
寫入以一般方式參考目標 (Target) 項目的運算式或指派陳述式 (Assignment Statement)。
```
grandTotal = 9000
```

在目標項目名稱前加上限定性條件字串。名稱後面會緊接著句號 (.)，此句號後面會跟著內含項目的模組、類別或結構。

' Assume the following module is part of your code.
Module accessGrandTotal
    Public Sub setGrandTotal()
        outerSpace.innerSpace.holdsTotals.totals.grandTotal = 9000
    End Sub
End Module

編譯器會使用限定性條件字串，來尋找和目標項目參考相符之清楚且明確的宣告。

如果應用程式存取一個以上的同名程式設計項目，則可能也必須限定名稱參考。例如，System.Windows.Forms 和 System.Web.UI.WebControls 命名空間都包含 Label 類別 (System.Windows.Forms.Label 和 System.Web.UI.WebControls.Label)。如果您的應用程式同時使用兩者，或是定義自己的 Label 類別，就必須區分不同的 Label 物件。請在變數宣告中加入命名空間或匯入別名。下列範例使用匯入別名。

' The following statement must precede all your declarations.
Imports win = System.Windows.Forms, web = System.Web.UI.WebControls
' The following statement references the Windows.Forms.Label class.
Dim winLabel As New win.Label()

其他包含項目的成員

當您使用其他類別或結構中的非共用成員時，必須先以指向該類別或結構的執行個體之變數或運算式完整描述成員名稱。在下列範例中，demoClass 是一個稱為 class1 的類別執行個體。

Dim demoClass As class1 = New class1()
demoClass.someSub[(argumentlist)]

您不能用類別名稱本身來限定非 Shared (Visual Basic) 成員名稱。必須先建立物件變數的執行個體 (本案例中的 demoClass)，然後以變數名稱進行參考。

如果類別或結構具有 Shared 成員，就可以使用類別或結構名稱或者是指向執行個體的變數或運算式，來限定該成員。

模組並沒有任何個別的執行個體，而其所有成員都預設值為 Shared。因此，您可以使用模組名稱來限定模組成員。

下列範例顯示對模組成員程序的限定參考。這個範例中宣告兩個 Sub 程序，兩者都命名為 perform，但位於專案的不同模組中。每一個都可以在自己的模組中指定，而不需要完整名稱，但若自其他地方參考則必須為完整名稱。因為 module3 中最後的參考並沒有限定 perform，所以編譯器無法解析該參考。

' Assume these three modules are all in the same assembly.
Module module1
    Public Sub perform()
        MsgBox("module1.perform() now returning")
    End Sub
End Module
Module module2
    Public Sub perform()
        MsgBox("module2.perform() now returning")
    End Sub
    Public Sub doSomething()
        ' The following statement calls perform in module2, the active module.
        perform()
        ' The following statement calls perform in module1.
        module1.perform()
    End Sub
End Module
Module module3
    Public Sub callPerform()
        ' The following statement calls perform in module1.
        module1.perform()
        ' The following statement makes an unresolvable name reference
        ' and therefore generates a COMPILER ERROR.
        perform() ' INVALID statement
    End Sub
End Module

專案參考

若要使用其他專案中定義的 Public (Visual Basic) 項目，您必須對該專案的組件或型別程式庫設定「參考」(Reference)。若要設定參考，請按一下 [專案] 功能表上的 [加入參考]，或使用 /reference (Visual Basic) 命令列編譯器選項。

例如，您可以使用 .NET Framework 的 XML 物件模型。如果設定對 System.Xml 命名空間的參考，就可以宣告並使用任何它的類別，例如 XmlDocument。下列的範例會使用 XmlDocument。

' Assume this project has a reference to System.Xml
' The following statement creates xDoc as an XML document object.
Dim xDoc As System.Xml.XmlDocument

匯入包含項目

您可以使用 Imports 陳述式 (.NET 命名空間和型別)來「匯入」(Import) 含有想使用的模組或類別的命名空間。這可讓您在不需使用完整名稱的情況下，即可參考匯入之命名空間中所定義的項目。下列範例會重新撰寫上一個範例，以匯入 System.Xml 命名空間。

' Assume this project has a reference to System.Xml
' The following statement must precede all your declarations.
Imports System.Xml
' The following statement creates xDoc as an XML document object.
Dim xDoc As XmlDocument

此外，Imports 陳述式可為每一個匯入的命名空間定義「匯入別名」(Import Alias)。這麼做可縮短原始程式碼，使其易於讀取。下列範例重新撰寫上一個範例，以使用 xD 做為 System.Xml 命名空間的別名。

' Assume this project has a reference to System.Xml
' The following statement must precede all your declarations.
Imports xD = System.Xml
' The following statement creates xDoc as an XML document object.
Dim xDoc As xD.XmlDocument

Imports 陳述式無法讓您的應用程式使用其他專案的項目。也就是說，它不會取代設定參考的功能。匯入命名空間即可除去完整描述該命名空間中定義名稱之必要性。

您也可以用 Imports 陳述式來匯入模組、類別、結構和列舉。之後不需要完整描述名稱就可以使用這些匯入項目的成員。但是，您必須永遠要使用評估為類別或結構執行個體的變數或運算式，來限定類別和結構的非共用成員名稱。

命名方針

如果您定義兩個以上具有相同名稱的程式設計項目，則當編譯器嘗試解析該名稱的參考時，可能會造成「名稱語意模糊」(Name Ambiguity)。當範圍中有一個以上的定義或是沒有定義時，就無法解析參考。相關的範例，請參考本說明頁面的＜限定參考的範例＞。

您可以為每一個項目提供專屬的名稱，以避免名稱語意模糊。那麼，不必使用命名空間、模組或類別限定名稱，就可以使用任何項目的參考。這樣也能降低不小心參考到錯誤項目的機會。

遮蔽

當兩個程式項目共用相同名稱時，其中之一可以隱藏，也就是「遮蔽」(Shadow) 另一個。遮蔽的項目無法參考，而在程式碼使用遮蔽的項目名稱時，Visual Basic 編譯器會將它解析為遮蔽項目。如需含有範例的詳細說明，請參閱 Visual Basic 中的遮蔽功能。

請參閱