Compartilhar via

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:

  • Ele deve começar com um caractere alfabético ou um 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 com um sublinhado.

  • Não deve ter mais de 1.023 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 elemento válidos.

aB123__45

_567

O exemplo a seguir mostra alguns nomes de elemento 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 e 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

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

Por outro lado, seu nome não deve ser tão curto que não descreva adequadamente o que o elemento representa e como seu código o usa. Isso é importante para a legibilidade do código. Se alguém estiver tentando entendê-lo, ou se você mesmo estiver olhando para ele muito tempo depois que você o escreveu, nomes de elementos adequados podem economizar uma quantidade considerável de tempo.

Nomes seguidos por caracteres de escape

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 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 usa os colchetes quando se refere ao nome posteriormente em seu código.

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

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

  • Você está trabalhando com código escrito em outro idioma no qual a palavra-chave fornecida não está 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 compara dois nomes que diferem apenas em maiúsculas de minúsculas alfabéticas, ele os interpreta como o mesmo nome. Por exemplo, ele considera ABC e abc se refere 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 você recompilar posteriormente 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, é garantido que eles corresponderão em todas as localidades.

Consulte também