Nomes de elementos 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:
Deve começar com um caractere alfabético ou um sublinhado (
_).Ele deve conter apenas caracteres alfabéticos, dígitos decimais e sublinhados.
Deve conter pelo menos um caractere alfabético ou dígito decimal se começar com um sublinhado.
Não deve 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
Atenção
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 compatível 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 de nome
Por uma questão prática, o seu nome deve ser o mais curto possível, sem deixar de identificar claramente a natureza do elemento. Isso melhora a legibilidade do seu 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 seu código. Se alguém está tentando entendê-lo, ou se você mesmo está olhando para ele muito tempo depois de tê-lo escrito, nomes de elementos adequados podem economizar uma quantidade considerável de tempo.
Nomes escapados
Geralmente, 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 com escape, que é colocado entre colchetes ([ ]). Um nome com escape pode corresponder a qualquer palavra-chave do Visual Basic, uma vez que os colchetes removem qualquer ambiguidade. Você também usa os colchetes quando se refere ao nome mais adiante no código.
Em geral, você deve usar nomes escapados somente quando:
Seu código migrou de uma versão anterior do Visual Basic que não reservou a palavra-chave que está sendo usada como um nome; quer
Você está trabalhando com código escrito em outro idioma no qual a palavra-chave dada não é reservada.
Caso contrário, você deve considerar renomear o elemento se seu nome entrar em conflito com uma palavra-chave. O ambiente de desenvolvimento integrado (IDE) fornece uma maneira fácil de fazer isso. Para obter mais informações, consulte Refatoração.
Diferenciação de maiúsculas e minúsculas nos nomes
Os nomes de elementos no Visual Basic não diferenciam maiúsculas de minúsculas. Isso significa que quando o compilador compara dois nomes que diferem apenas em maiúsculas e minúsculas, ele os interpreta como o mesmo nome. Por exemplo, considera ABC e abc refere-se ao mesmo elemento declarado.
No entanto, o Common Language Runtime (CLR) 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 mais 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, você não deve alterar o caso alfabético de quaisquer elementos públicos.
Nomes e localidades
A comparação de nomes é independente da localidade. Se dois nomes corresponderem em uma localidade, é garantido que corresponderão em todas as localidades.
