Share via


Nomes de elemento declarados (Visual Basic)

Cada elemento declarado tem um nome, também chamado de identificador, que é o que o código usa para se referir a ele.

Regras

Um nome de elemento no Visual Basic deve observar as seguintes regras:

  • Ele precisa começar com um caractere alfabético ou sublinhado (_).

  • Ele deve conter apenas caracteres alfabéticos, dígitos decimais e sublinhados.

  • Ele deve conter pelo menos um caractere alfabético ou dígito decimal se começar por um sublinhado.

  • Ele não pode ter mais de 1023 caracteres.

O limite de comprimento de 1023 caracteres também se aplica a toda a cadeia de caracteres de um nome totalmente qualificado, como outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

O exemplo a seguir mostra alguns nomes de elementos válidos.

aB123__45

_567

O exemplo a seguir mostra alguns nomes de elementos inválidos. O primeiro contém apenas um sublinhado, o segundo começa com um dígito decimal e o terceiro contém um caractere inválido ($).

' Three INVALID element names

_

12ABC

xyz$wv

Cuidado

Os nomes de elementos que começam com um sublinhado (_) não fazem parte do CLS (Language Independence and Language-Independent Components), portanto, o código em conformidade com CLS não pode usar um componente que defina esses nomes. No entanto, um sublinhado em qualquer outra posição em um nome de elemento é compatível com CLS.

Diretrizes de Comprimento do Nome

Por uma questão prática, o nome deve ser o mais curto possível mas ainda identificar claramente a natureza do elemento. Isso melhora a legibilidade do código e reduz o comprimento da linha e o tamanho do arquivo de origem.

Por outro lado, seu nome não deve ser tão curto a ponto de não descrever adequadamente o que o elemento representa e como seu código o usa. Isso é importante para a legibilidade do código. Se outra pessoa estiver tentando entendê-lo ou se você mesmo estiver olhando para ele por muito tempo depois de escrevê-lo, os nomes de elementos apropriados podem economizar tempo.

Nomes seguidos por caracteres de escape

Em geral, um nome de elemento não deve corresponder a nenhuma das palavras-chave reservadas pelo Visual Basic, como Case ou Friend. No entanto, você pode definir um nome de escape, que ficará entre colchetes ([ ]). Um nome com escape pode corresponder a qualquer palavra-chave do Visual Basic, já que os colchetes removem qualquer ambiguidade. Você também deve usar os colchetes ao se referir ao nome posteriormente em seu código.

Em geral, você deve usar nomes com escape somente quando:

  • Seu código tiver migrado de uma versão anterior do Visual Basic que não reservava a palavra-chave que estava sendo usada como um nome; ou

  • Você estiver trabalhando com código escrito em outro idioma no qual a palavra-chave fornecida não é reservada.

Caso contrário, você deverá considerar renomear o elemento se seu nome entrar em conflito com uma palavra-chave. O IDE (ambiente de desenvolvimento integrado) fornece uma maneira fácil de fazer isso. Para obter mais informações, consulte Refatoração.

Sensibilidade de Maiúsculas e Minúsculas em Nomes

Os nomes de elementos no Visual Basic não diferenciam maiúsculas de minúsculas. Isso significa que quando o compilador do Visual Basic compara dois nomes que diferem apenas em casos alfabéticos ele os interpreta como o mesmo nome. Por exemplo, ele considera que ABC e abc se referem ao mesmo elemento declarado.

No entanto, o CLR (Common Language Runtime) usa associação que diferencia maiúsculas de minúsculas. Portanto, quando você produz um assembly ou uma DLL e o disponibiliza para outros assemblies, seus nomes não diferenciam maiúsculas de minúsculas. Por exemplo, se você definir uma classe com um elemento chamado ABC e outros assemblies usarem sua classe por meio do Common Language Runtime, eles deverão se referir ao elemento como ABC. Se, posteriormente, você recompilar sua classe e alterar o nome do elemento para abc, os outros assemblies que usam sua classe não poderão mais acessar esse elemento. Portanto, quando você lança uma versão atualizada de um assembly, não deve alterar o as maiúsculas e minúsculas alfabéticas de nenhum elemento público.

Nomes e localidades

A comparação de nomes é independente da localidade. Se dois nomes corresponderem em uma localidade, garante-se que eles corresponderão em todas as localidades.

Confira também