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
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
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
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.
Scrivere l'espressione o l'istruzione di assegnazione facendo riferimento all'elemento di destinazione nel modo normale.
grandTotal = 9000
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
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