Nomi di elementi dichiarati (Visual Basic)

A ogni elemento è assegnato un nome, detto anche identificatore, che viene usato dal codice 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 superare i 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 di elementi che iniziano con un carattere di sottolineatura (_) non sono inclusi nelle specifiche Language Independence and Language-Independent Components (CLS), quindi il codice conforme a CLS non può usare 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. Questo requisito 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 da non descrivere 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 lo si sta guardando dopo un lungo periodo, avere nomi di elementi adatti consente di risparmiare molto tempo.

Nomi con caratteri di escape

In generale, 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 con caratteri di escape, ovvero racchiuso tra parentesi quadre ([ ]). Un nome con caratteri di escape può corrispondere a qualsiasi parola chiave di Visual Basic, perché le parentesi quadre consentono di evitare ambiguità. È anche possibile usare le parentesi quadre quando si fa riferimento al nome più avanti nel codice.

In generale, è consigliabile usare nomi con caratteri di escape solo nei casi seguenti:

  • È stata eseguita la migrazione del codice da una versione precedente di Visual Basic che non ha riservato la parola chiave usata come nome oppure

  • Si usa 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. È possibile eseguire facilmente questa operazione nell'ambiente di sviluppo integrato (IDE). Per altre informazioni, vedere Refactoring.

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 contenenti caratteri alfabetici che differiscono solo per l'uso di maiuscole/minuscole, li interpreta come lo stesso nome. Ad esempio, se si ha ABC e abc , il compilatore li interpreta come se facessero riferimento allo stesso elemento dichiarato.

Il Common Language Runtime (CLR) usa invece l'associazione che distingue fra maiuscole e minuscole . Perciò, quando si genera un assembly o una DLL e la si rende disponibile ad altri assembly, i nomi distinguono fra maiuscole e minuscole. Se ad esempio si definisce una classe con un elemento denominato ABCe altri assembly usano la classe mediante il Common Language Runtime, devono fare riferimento all'elemento come ABC. Se in seguito si ricompila la classe e si cambia il nome dell'elemento in abc, gli altri assembly che usano la classe potrebbero non accedere più a tale elemento. Pertanto, quando si rilascia una versione aggiornata di un assembly, non si devono modificare le maiuscole e le minuscole degli elementi pubblici.

Nomi e impostazioni locali

Il confronto dei nomi è indipendente dalle impostazioni locali. Se due nomi corrispondono in un'impostazione locale, corrisponderanno sicuramente in tutte le impostazioni locali.

Vedi anche