宣言された要素の参照 (Visual Basic)

  • [アーティクル]

宣言された要素をコードから参照するときには、Visual Basic のコンパイラが、参照内の名前をその名前の適切な宣言に対応させる必要があります。 複数の要素が同じ名前で宣言されている場合は、名前に修飾子を付けることによって、参照する要素を指定できます。

コンパイラは、最も狭いスコープの中で名前の参照と一致する名前の宣言を検索します。 これは、この参照が行われているコードを起点として、起点を含んでいる最も内側のコンテナー要素から外側のレベルへと順に検索範囲を拡大していくことを意味します。

次の例は、同じ名前を持つ 2 つの変数への参照を示します。 この例では、同じ totalCount という名前を持ち、container モジュール内でのスコープ レベルが異なる 2 つの変数を宣言しています。 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

要素名の修飾

この検索処理をオーバーライドし、より広いスコープで宣言されている名前を指定する場合には、より広いスコープを持つコンテナー要素によって変数名を修飾する必要があります。 場合によっては、コンテナー要素をさらに修飾する必要もあります。

名前を修飾するということは、ソース ステートメント内で、ターゲットの要素が定義された場所を識別する情報よりも前に置くことを意味します。 この情報は、修飾文字列と呼ばれます。 1 つまたは複数の名前空間とモジュール、クラス、または構造体を含めることができます。

修飾文字列では、明確にモジュール、クラス、またはターゲット要素を含む構造体を指定する必要があります。 コンテナーは、その代わりに他のコンテナー要素、通常は名前空間に配置されます。 修飾文字列にはいくつかのコンテナー要素を含める必要があります。

名前を修飾して宣言された要素にアクセスするには

  1. 要素が定義された場所を特定します。 これには、名前空間、あるいは名前空間の階層までもが含まれる場合があります。 最下位レベルの名前空間では、要素はモジュール、クラス、または構造体に含まれている必要があります。

    ' 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

  2. ターゲット要素の場所に基づいて修飾パスを決定します。 最高位レベルの名前空間から始まり、最下位レベルの名前空間まで進み、ターゲット要素を含むモジュール、クラス、または構造体で終わります。 パス内の各要素は、その後に続く要素を含む必要があります。

    outerSpace → innerSpace → holdsTotals → totals

  3. ターゲット要素の修飾文字列を準備します。 パス内の各要素の後ろにはピリオド (.) を付ける必要があります。 アプリケーションは、修飾文字列内のすべての要素に対するアクセス権限を持っている必要があります。

    outerSpace.innerSpace.holdsTotals.totals.

  4. 通常の方法で、ターゲット要素を参照する式または代入ステートメントを作成します。

    grandTotal = 9000

  5. ターゲットの要素名は修飾文字列に先行します。 要素を含むモジュール、クラス、または構造体の後ろのピリオド (.) の直後に、名前を指定する必要があります。

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

  6. コンパイラは修飾文字列を使用して、ターゲット要素の参照と対応する、明白で、あいまいでない宣言を特定します。

同じ名前を持つ複数のプログラミング要素にアプリケーションからアクセスする場合にも、名前参照の修飾が必要になることがあります。 たとえば、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 です。 したがって、モジュール メンバーはモジュール名で修飾します。

モジュール メンバー プロシージャに対する参照を修飾する例を次に示します。 この例では、同じ perform という名前を持ち、プロジェクト内の別々のモジュールにある 2 つの Sub プロシージャを宣言しています。 どちらのプロシージャについても、宣言されたモジュール内で指定するときには修飾子を必要としませんが、それ以外の場所から参照するときには修飾子が必要です。 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 (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 名前空間および型) を使うと、使用するモジュールやクラスを含む名前空間をインポートできます。 インポートした名前空間で定義されている要素は、名前を完全修飾せずに参照できます。 次の例では、前の例を書き直して 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 ステートメントでは、インポートする各名前空間のインポート エイリアスを定義することもできます。 インポート エイリアスを使用すると、ソース コードが短くてわかりやすいものになります。 次の例では、前の例を書き直して、System.Xml 名前空間のエイリアスとして xD を使用しています。

' 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 ステートメントを使って、モジュール、クラス、構造体、および列挙値をインポートすることもできます。 インポートした要素のメンバーは、修飾子を付けずに使用できます。 ただし、クラスや構造体の非共有メンバーについては、常に、クラスまたは構造体のインスタンスになる変数または式を使って修飾する必要があります。

名前付けのガイドライン

同じ名前を持つ複数のプログラミング要素を定義すると、コンパイラがその名前への参照を解決しようとするときに、名前のあいまいさの問題が発生する可能性があります。 スコープ内に複数の定義がある場合、またはスコープ内に定義がない場合、参照は解決できません。 例については、このヘルプ ページの「参照の修飾例」を参照してください。

名前のあいまいさを回避するには、すべての要素に一意の名前を付けます。 そうすることで、名前空間、モジュール、またはクラスによって名前を修飾することなく、任意の要素を参照できます。 また、誤って異なる要素を参照する可能性も少なくなります。

シャドウ

2 つのプログラミング要素が同じ名前を持つときに、一方の要素によってもう一方の要素が隠されることがあります。これをシャドウと呼びます。 シャドウで隠された要素は参照できません。シャドウされた要素の名前をコードで使用すると、Visual Basic コンパイラはそれをシャドウする要素 (隠されていない方の要素) に解決します。 詳細と例については、「Visual Basic におけるシャドウ」を参照してください。

参照

処理手順

方法 : プロジェクト プロパティおよび構成設定を変更する

参照

Imports ステートメント (.NET 名前空間および型)

New 演算子 (Visual Basic)

Public (Visual Basic)

概念

宣言された要素の名前 (Visual Basic)

宣言された要素の特性 (Visual Basic)

Visual Basic における変数