Partilhar via


Convenções de nomenclatura do Visual Basic

Quando você nomeia um elemento em seu aplicativo Visual Basic, o primeiro caractere desse nome deve ser um caractere alfabético ou um sublinhado. Observe, no entanto, que os nomes que começam com um sublinhado não são compatíveis com o Language Independence and Language Independent Components (CLS).

As sugestões a seguir se aplicam à nomenclatura.

  • Comece cada palavra separada em um nome com uma letra maiúscula, como em FindLastRecord e RedrawMyForm.

  • Comece nomes de funções e métodos com um verbo, como em InitNameArray ou CloseDialog.

  • Comece os nomes de classe, estrutura, módulo e propriedade com um substantivo, como em EmployeeName ou CarAccessory.

  • Comece os nomes da interface com o prefixo "I", seguido por um substantivo ou uma frase nominal, como IComponent, ou com um adjetivo descrevendo o comportamento da interface, como IPersistable. Não use o sublinhado e use abreviaturas com moderação, porque as abreviaturas podem causar confusão.

  • Comece os nomes do manipulador de eventos com um substantivo descrevendo o tipo de evento seguido pelo sufixo "EventHandler", como em "MouseEventHandler".

  • Em nomes de classes de argumento de evento, inclua o sufixo "EventArgs".

  • Se um evento tem um conceito de "antes" ou "depois", use um sufixo no tempo presente ou passado, como em "ControlAdd" ou "ControlAdded".

  • Para termos longos ou usados com frequência, use abreviaturas para manter os comprimentos de nome razoáveis, por exemplo, "HTML", em vez de "Hypertext Markup Language". Em geral, nomes de variáveis com mais de 32 caracteres são difíceis de ler em um monitor definido para uma resolução baixa. Além disso, certifique-se de que suas abreviaturas sejam consistentes em todo o aplicativo. Alternar aleatoriamente em um projeto entre "HTML" e "Hypertext Markup Language" pode levar a confusão.

  • Evite usar nomes em um escopo interno que sejam iguais aos nomes em um escopo externo. Erros podem ocorrer se a variável errada for acessada. Se ocorrer um conflito entre uma variável e a palavra-chave do mesmo nome, você deverá identificar a palavra-chave precedendo-a com a biblioteca de tipos apropriada. Por exemplo, se você tiver uma variável chamada Date, poderá usar a função intrínseca Date somente chamando DateTime.Date.

Consulte também