Condividi tramite


Procedura: qualificare il nome di un elemento dichiarato

Aggiornamento: novembre 2007

Quando il codice fa riferimento a un elemento dichiarato, il compilatore Visual Basic deve creare una corrispondenza tra il nome nel riferimento e la dichiarazione corretta di tale nome. Se l'elemento è definito all'esterno del codice o se sono dichiarati più elementi con lo stesso nome, può essere necessario qualificare il nome per consentire al compilatore di risolvere le eventuali ambiguità o di individuare l'elemento stesso.

Qualificare un nome significa farlo precedere, nell'istruzione del codice sorgente, da informazioni che identificano la posizione in cui è definito l'elemento di destinazione. Tali informazioni costituiscono la stringa di qualificazione e possono includere uno o più spazi dei nomi oltre a un modulo, una classe o una struttura.

Nella stringa di qualificazione deve essere specificato in modo non ambiguo il modulo, la classe o la struttura contenente l'elemento di destinazione. Il contenitore può essere posizionato in un altro contenitore, in genere uno spazio dei nomi. Può essere necessario includere nella stringa di qualificazione numerosi contenitori.

Per accedere a un elemento dichiarato mediante la qualificazione del relativo nome

  1. Determinare la posizione in cui l'elemento è stato definito. Tale posizione può includere uno spazio dei nomi o anche una gerarchia di spazi dei nomi. All'interno dello spazio dei nomi di livello inferiore l'elemento deve essere contenuto in un modulo, una classe o una struttura.

    ' 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. Determinare un percorso di qualificazione in base al percorso dell'elemento di destinazione. Iniziare con lo spazio dei nomi di livello superiore, procedere fino a quello di livello inferiore, quindi concludere con il modulo, la classe o la struttura contenente l'elemento di destinazione. Ciascun elemento del percorso deve contenere l'elemento immediatamente successivo.

    outerSpace → innerSpace → holdsTotals → totals

  3. Preparare la stringa di qualificazione per l'elemento di destinazione. Inserire un punto (.) dopo ciascun elemento presente nel percorso. L'applicazione deve essere in grado di accedere a ogni elemento della stringa di qualificazione.

    outerSpace.innerSpace.holdsTotals.totals.
    
  4. Scrivere l'espressione o l'istruzione di assegnazione facendo riferimento all'elemento di destinazione nel modo normale.

    grandTotal = 9000
    
  5. Prima del nome dell'elemento di destinazione inserire la stringa di qualificazione. Il nome deve seguire immediatamente il punto (.) posto dopo il modulo, la classe o la struttura contenente l'elemento.

    ' 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. Il compilatore utilizza la stringa di qualificazione per individuare una dichiarazione chiara e non ambigua da associare al riferimento all'elemento di destinazione.

Vedere anche

Attività

Procedura: distinguere tra due elementi con lo stesso nome

Procedura: nascondere una variabile con lo stesso nome di un'altra variabile

Procedura: nascondere una variabile ereditata

Procedura: accedere a una variabile nascosta da una classe derivata

Concetti

Caratteristiche di elementi dichiarati

Risoluzione di un riferimento quando più variabili hanno lo stesso nome

Istruzioni di dichiarazione in Visual Basic

Altre risorse

Riferimenti a elementi dichiarati