Condividi tramite

Nomi di elemento dichiarati (Visual Basic)

Ogni elemento dichiarato ha un nome, detto anche identificatore, che è ciò che il codice usa per farvi riferimento.

Regole

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

  • Deve iniziare con un carattere alfabetico o un carattere di sottolineatura (_).

  • Deve contenere solo caratteri alfabetici, cifre decimali e caratteri di sottolineatura.

  • Deve contenere almeno un carattere alfabetico o una cifra decimale se inizia con un carattere di sottolineatura.

  • Non deve contenere più 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 seguente vengono illustrati alcuni nomi di elemento validi.

aB123__45

_567

Nell'esempio seguente vengono 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 degli elementi che iniziano con un trattino basso (_) non fanno parte della Indipendenza dal Linguaggio e Componenti Language-Independent (CLS), quindi il codice conforme a CLS non può utilizzare un componente che definisce tali nomi. Tuttavia, un carattere di sottolineatura in qualsiasi altra posizione in un nome di elemento è conforme a CLS.

Linee guida per la lunghezza dei nomi

In pratica, il nome dovrebbe essere il più breve possibile, pur identificando chiaramente la natura dell'elemento. Ciò migliora la leggibilità del codice e riduce la lunghezza della riga e le dimensioni del file di origine.

D'altra parte, il nome non deve essere così breve che non descrive adeguatamente cosa rappresenta l'elemento e come viene usato dal codice. Questo aspetto è importante per la leggibilità del codice. Se qualcun altro sta cercando di comprenderlo, o se tu stesso lo stai guardando molto tempo dopo averlo scritto, i nomi di elementi adatti possono risparmiare una notevole quantità di tempo.

Nomi preceduti da escape

In genere, un nome di elemento non deve corrispondere ad alcuna parola chiave riservata da Visual Basic, ad esempio Case o Friend. Tuttavia, è possibile definire un nome preceduto da escape, racchiuso tra parentesi quadre ([ ]). Un nome preceduto da escape può corrispondere a qualsiasi parola chiave di Visual Basic, poiché le parentesi quadre rimuovono qualsiasi ambiguità. È anche possibile usare le parentesi quadre quando si fa riferimento al nome più avanti nel codice.

In generale, è consigliabile usare nomi preceduti da escape solo quando:

  • Il codice è stato migrato da una versione precedente di Visual Basic che non ha riservato la parola chiave usata come nome; o

  • Si sta lavorando con il codice scritto in un altro linguaggio in cui la parola chiave specificata non è riservata.

In caso contrario, è consigliabile rinominare l'elemento se il nome è in conflitto con una parola chiave. L'ambiente di sviluppo integrato (IDE) offre un modo semplice per eseguire questa operazione. Per altre informazioni, vedere Refactoring.

Distinzione tra maiuscole e minuscole nei nomi

I nomi degli elementi in Visual Basic non fanno distinzione tra maiuscole e minuscole. Ciò significa che quando il compilatore confronta due nomi che differiscono solo in lettere alfabetiche, li interpreta come lo stesso nome. Ad esempio, considera ABC e abc fa riferimento allo stesso elemento dichiarato.

Tuttavia, il Common Language Runtime (CLR) utilizza l'associazione che distingue tra lettere maiuscole e minuscole. Pertanto, quando si produce un assembly o una DLL e lo si rende disponibile ad altri assembly, i nomi non fanno più distinzione tra maiuscole e minuscole. Ad esempio, se si definisce una classe con un elemento denominato ABCe altri assembly usano la classe tramite Common Language Runtime, devono fare riferimento all'elemento come ABC. Se successivamente si ricompila la classe e si modifica il nome dell'elemento in abc, gli altri assembly che usano la classe non potranno più accedere a tale elemento. Pertanto, quando si rilascia una versione aggiornata di un assembly, non si dovrebbe modificare il maiuscolo/minuscolo di alcun elemento pubblico.

Nomi e impostazioni locali

Il confronto dei nomi è indipendente dalle impostazioni della lingua locale. Se due nomi corrispondono in un'unica impostazione locale, è garantito che corrispondano in tutte le impostazioni locali.

Vedere anche