Nomi di elementi dichiarati

Articolo
09/12/2008

Aggiornamento: novembre 2007

Ogni elemento dichiarato ha un nome, detto anche identificatore, utilizzato dal codice per riferirsi a esso.

Regole

Il nome di un elemento in Visual Basic deve rispettare le seguenti regole:

Deve iniziare con un carattere alfabetico o un carattere di sottolineatura (_).
Deve contenere solo caratteri alfabetici, cifre decimali e caratteri di sottolineatura.
Se inizia con un carattere di sottolineatura, deve contenere almeno un carattere alfabetico o una cifra decimale.
Non deve superare la lunghezza massima di 1023 caratteri.

Il limite di lunghezza di 1023 caratteri si applica anche all'intera stringa di un nome completo, ad esempio outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

Nell'esempio riportato di seguito sono illustrati alcuni nomi di elemento validi.

aB123__45

_567

Nell'esempio riportato di seguito sono illustrati alcuni nomi di elemento non validi. Il primo contiene solo un carattere di sottolineatura, il secondo inizia con una cifra decimale e il terzo contiene un carattere non valido ($).

' Three INVALID element names

12ABC

xyz$wv

Attenzione:
I nomi di elemento che iniziano con un carattere di sottolineatura (_) non fanno parte di Specifiche CLS (Common Language Specification) (CLS), pertanto non è possibile utilizzare un componente che definisce tali nomi in codice compatibile con CLS. Tuttavia, il carattere di sottolineatura è compatibile con CLS in qualsiasi altra posizione all'interno di un nome di elemento.

Indicazioni sulla lunghezza dei nomi

Per una questione pratica, il nome dovrebbe essere il più breve possibile e al tempo stesso identificare chiaramente la tipologia dell'elemento. Questo consente di migliorare la leggibilità del codice e di ridurre la lunghezza delle righe e la dimensione del file di origine.

D'altro canto, è necessario che il nome abbia una lunghezza sufficiente per descrivere adeguatamente l'elemento e il modo in cui deve essere utilizzato dal codice. Questa caratteristica è importante per la leggibilità del codice. L'utilizzo di nomi appropriati consente infatti un notevole risparmio di tempo sia agli altri utenti che dovranno comprendere la funzione dell'elemento che allo stesso autore che dovrà riutilizzare l'elemento dopo un lungo periodo di tempo.

Nomi forzati

Un nome di elemento, in genere, non deve coincidere con una delle parole chiave riservate da Visual Basic, ad esempio Case o Friend. È tuttavia possibile definire un nome forzato, racchiuso tra parentesi ([ ]). Un nome forzato può corrispondere a una parola chiave di Visual Basic, in quanto le parentesi eliminano qualsiasi ambiguità. Utilizzare le parentesi anche quando si fa riferimento al nome in un punto successivo del codice.

In generale, l'utilizzo dei nomi forzati è necessario solo nei seguenti casi:

È stata eseguita la migrazione del codice da una versione precedente di Visual Basic in cui la parola chiave utilizzata come nome non era riservata.
Si sta utilizzando codice scritto in un altro linguaggio, in cui la parola chiave specificata non è riservata.

Negli altri casi, si consiglia di rinominare l'elemento se il nome dell'elemento è in conflitto con una parola chiave. A questo scopo è possibile utilizzare l'ambiente di sviluppo integrato (IDE, Integrated Development Environment). Per ulteriori informazioni, vedere Procedura: rinominare un identificatore.

Distinzione tra maiuscole e minuscole nei nomi

Per i nomi degli elementi in Visual Basic non viene fatta distinzione tra maiuscole e minuscole. Questo significa che, quando il compilatore confronta due nomi che differiscono solo nelle maiuscole e minuscole, li interpreta come se fossero lo stesso nome. ABC e abc, ad esempio, sono considerati come riferimenti allo stesso elemento dichiarato.

Nel Common Language Runtime, tuttavia, viene utilizzata l'associazione con distinzione tra maiuscole e minuscole. Di conseguenza, quando si genera un assembly o una DLL e li si rende disponibili per altri assembly, per i nomi utilizzati verrà fatta distinzione tra maiuscole e minuscole. Se ad esempio si definisce una classe con un elemento denominato ABC e altri assembly utilizzano tale classe tramite il Common Language Runtime, è necessario che gli assembly facciano riferimento all'elemento come ABC. Se, successivamente, la classe viene ricompilata e il nome dell'elemento viene cambiato in abc, gli altri assembly che utilizzano la classe non potranno più accedere all'elemento. Di conseguenza, quando si rilascia una versione aggiornata di un assembly, è preferibile non modificare le maiuscole e le minuscole degli elementi pubblici.

Nomi e impostazioni internazionali

Il confronto tra i nomi è indipendente dalle impostazioni internazionali in uso. Se due nomi corrispondono in un ambiente con determinate impostazioni internazionali, tali nomi coincideranno in tutti gli ambienti.