Gewusst wie: Qualifizieren eines deklarierten Elementnamens

Aktualisiert: November 2007

Wenn im Code auf ein deklariertes Element verwiesen wird, muss der Visual Basic-Compiler den Namen im Verweis der entsprechenden Deklaration dieses Namens zuweisen. Wenn das Element nicht in der betreffenden Codedatei definiert ist oder wenn mehrere Elemente mit dem gleichen Namen deklariert wurden, müssen Sie den Namen möglicherweise qualifizieren, damit der Compiler mögliche Mehrdeutigkeiten auflösen bzw. das Element finden kann.

"Qualifizieren eines Namens" bedeutet, dass Sie dem Namen in der Codeanweisung Informationen voranstellen, die angeben, wo das Zielelement definiert ist. Diese Informationen werden als Qualifizierungspfad bezeichnet. Diese Angabe kann einen oder mehrere Namespaces und ein Modul, eine Klasse oder Struktur enthalten.

Der Qualifizierungspfad muss das Modul, die Klasse oder Struktur, das bzw. die das Zielelement enthält, eindeutig angeben. Der Container kann sich wiederum in einem anderen enthaltenden Element befinden, meist einem Namespace. Unter Umständen müssen Sie mehrere enthaltende Elemente in den Qualifizierungspfad aufnehmen.

So greifen Sie auf ein deklariertes Element zu, indem Sie seinen Namen qualifizieren

1. Ermitteln Sie die Stelle, an der das Element definiert wurde. Diese Angabe kann einen Namespace oder sogar eine Hierarchie von Namespaces beinhalten. Innerhalb des Namespaces der untersten Ebene muss das Element in einem Modul, einer Klasse oder Struktur enthalten sein.

   ' 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. Legen Sie auf der Grundlage der Position des Zielelements einen Qualifizierungspfad fest. Sie beginnen mit dem Namespace der obersten Ebene, fahren fort bis zum Namespace der untersten Ebene und beenden die Angabe mit dem Modul, der Klasse oder Struktur, das bzw. die das Zielelement enthält. Jedes Element im Pfad muss das ihm nachfolgende Element enthalten.

   outerSpace → innerSpace → holdsTotals → totals

3. Stellen Sie den Qualifizierungspfad für das Zielelement zusammen. Fügen Sie nach jedem Pfadelement einen Punkt (.) ein. Die Anwendung muss Zugriff auf jedes Element im Qualifizierungspfad haben.

   outerSpace.innerSpace.holdsTotals.totals.
   

4. Erstellen Sie den Ausdruck oder die Zuweisungsanweisung. Verweisen Sie dabei in der üblichen Weise auf das Zielelement.

   grandTotal = 9000
   

5. Stellen Sie den Qualifizierungspfad dem Namen des Zielelements voran. Der Name muss unmittelbar nach dem Punkt (.) angegeben werden, der dem Modul, der Klasse oder Struktur folgt, das bzw. die das Element enthält.

   ' 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. Der Compiler sucht anhand des Qualifizierungspfads eine klare, eindeutige Deklaration, der der Verweis auf das Zielelement zugeordnet werden kann.

Siehe auch

Aufgaben

Gewusst wie: Unterscheiden zwischen zwei Elementen mit dem gleichen Namen

Gewusst wie: Ausblenden einer Variablen mit dem gleichen Namen wie die aktuelle Variable

Gewusst wie: Ausblenden einer geerbten Variablen

Gewusst wie: Zugreifen auf eine Variable, die von einer abgeleiteten Klasse ausgeblendet wird

Konzepte

Merkmale deklarierter Elemente

Auflösen eines Verweises bei mehreren Variablen mit gleichem Namen

Deklarationsanweisungen in Visual Basic

Weitere Ressourcen

Verweise auf deklarierte Elemente