De um modo geral, para o C#, o padrão camel case é amplamente utilizado. Resumindo, nesse padrão, os nomes são compostos simplesmente unindo-os sem qualquer tipo de separador, como o sublinhado (_). O que ajuda a diferenciar as palavras é o FatoDeCadaUmaIniciarComMaiúscula. Além disso, escolher bem o nome do elemento pode contribuir - e muito - para o entendimento de seu código pela equipe (e por você mesmo, na hora de voltar depois de uns meses para uma eventual manutenção). Abaixo algumas considerações que podem facilitar na hora de escolher o nome de seus identificadores:
Seja claro!
Em primeiro lugar, escolha um nome que dê sentido àquele elemento. Leia novamente o código, como se fosse um texto em português e tente avaliar se a frase que acabou de ler faz sentido, ou seja, se é coerente e não induz o leitor à qualquer tipo de ambiguidade. Se você não lembra pra que serve uma variável (x
é um péssimo nome), é provável que tenha escolhido o nome errado.
Abreviações
Geralmente, siglas e abreviações tendem a atrapalhar o entendimento do código, a menos que sejam amplamente utilizadas por todos na equipe e na empresa. Um padrão cada vez mais em desuso, a notação húngara, prevê o uso de abreviações para a nomeação de controles e até hoje muita gente a usa para dar nomes a elementos do banco de dados. Assim, uma caixa de texto poderia se chamar txtNome
. Ao optar por uma linguagem mais eloquente, a abreviação seria substituída por textBoxNome
.
Linguagem ubíqua
Por influência de Eric Evans, em seu livro Domain Driven Design, há uma tendência em atribuir nomes que expressem antes o negócio e depois a tecnologia. Pra um desenvolvedor isso representa um desafio, pois nos expressamos a maior parte do tempo usando uma linguagem essencialmente técnica e cheia de termos próprios. Focando no negócio, o controle txtNome passaria a ser chamado nomeTextBox
, por exempo. Linguagem ubíqua é considerada aquela que todos os envolvidos falam, que está presente no vocabulário cotidiano da organização e facilita o entendimento de um conceito por todos.
Maiúsculas e minúsculas
No padrão CamelCase é comum que haja distinção para a primeira inicial:
- para Classes, é em maiúscula:
SituacaoVenda
. Para Constantes e Enumeradores também.
- para objetos, controles e variáveis, em minúscula:
notaFiscal
, contadorItemNotaFiscal
.
Tamanho
O limite para o tamanho do nome de um identificador é o bom senso apenas, não há limitação imposta pelo framework. Assim, nomes muito extensos podem ocupar muito espaço na tela e atrapalhar a leitura. É bom lembrar também que, para nomes de controles na web (na view, propriamente), a questão do tamanho pode impactar o tráfego de dados, já que cada caractere representa um byte
.
Caracteres especias
No C#, é comum usar o sublinhado (underline, underscore) para inicializar os campos privados, também conhecidos como atributos. São aqueles elementos declarados no escopo da classe e, portanto, disponíveis para todos os métodos dessa classe. Assim, um campo para representar o repositório de clientes poderia se chamar _clienteRepositorio
.
Toda linguagem possui suas palavras reservadas (key words). No C# é possível usar o arroba (@) se for muito necessário que uma variável se chame class, por exemplo (@class).
Ferramentas de produtividade
O próprio Visual Studio sugere nomes para controles usando esses padrões. Se você cria um item de menu com a descrição Clientes, a IDE vai sugerir que o respectivo nome do controle seja clientesMenuItem, por exemplo.
Outra ferramenta que implementa essas práticas é o ReSharper, da JetBrains. Essa ferramenta já sugere um conjunto bem mais abrangente de boas práticas, destacando no código a nomenclatura que foge ao padrão.