Compartilhar via


Convenções de nomenclatura do Visual Basic

Quando você nomeia um elemento em seu aplicativo do Visual Basic, o primeiro caractere desse nome deverá ser um caractere alfabético ou um sublinhado. No entanto, observe que os nomes que começam com um sublinhado não estão em conformidade com a CLS (Independência da Linguagem e Componentes Independentes de Linguagem).

As sugestões a seguir se aplicam à nomenclatura.

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

  • Inicie nomes de função e método com um verbo, como em InitNameArray ou CloseDialog.

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

  • Inicie nomes de 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 abreviações com moderação, pois abreviações podem causar confusão.

  • Inicie os nomes do manipulador de eventos com um substantivo que descreve 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 tiver um conceito de "antes" ou "depois", use um sufixo no tempo presente ou passado, como em "ControlAdd" ou "ControlAdded".

  • Para termos longos ou frequentemente usados, use abreviações para manter os comprimentos de nome razoáveis, por exemplo, "HTML", em vez de "Linguagem de Marcação de Hipertexto". Em geral, nomes de variáveis maiores que 32 caracteres são difíceis de ler em um monitor definido com uma resolução baixa. Além disso, verifique se suas abreviações são consistentes em todo o aplicativo. Alternar aleatoriamente em um projeto entre "HTML" e "Linguagem de Marcação de Hipertexto" pode causar confusão.

  • Evite usar nomes em um escopo interno que sejam os mesmos que nomes em um escopo externo. Podem ocorrer erros se a variável errada for acessada. Se ocorrer um conflito entre uma variável e a palavra-chave de 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 apenas chamando DateTime.Date.

Confira também