Convenções maiúsculas
Muitas das convenções de nomes pertencem ao uso de maiúsculas e minúsculas de identificadores. É importante observar que o common linguagem tempo de execução (CLR) suporta caso - confidenciais e caso-diferenciação de idiomas. As convenções de uso de maiúsculas descritas neste tópico facilitam para os desenvolvedores a compreender e trabalhar com uma biblioteca.
Estilos de maiúsculas e minúsculas
Os termos a seguir descrevem as maneiras diferentes identificadores de maiúsculas.
Pascal cobertura
A primeira letra do identificador e a primeira letra de cada palavra concatenada subseqüente estão em maiúsculas. Você pode usar caso Pascal para identificadores de três ou mais caracteres. Por exemplo:
BackColor
Cobertura Camel
A primeira letra de um identificador é em minúsculas e a primeira letra de cada palavra concatenada subseqüente é maiúscula. Por exemplo:
backColor
Letras maiúsculas
O identificador de todas as letras estão em maiúsculas. Por exemplo:
IO
Regras de uso de maiúsculas e minúsculas para identificadores
Quando um identificador consiste em várias palavras, não use separadores, sistema autônomo o sublinhado ("_") ou hifens ("-") entre sistema autônomo palavras. Em vez disso, use casing para indicar o início de cada palavra.
As diretrizes a seguir fornecem as regras Geral para identificadores.
Use Pascal casing para todos os públicos espaço para nome, tipo e membro nomes consiste em várias palavras.
Observe que essa regra não se aplica a campos de instância. Por motivos que estão detalhados no Diretrizes de design de membro, você não deve usar campos de instância pública.
Use camel casing para nomes de parâmetro.
A tabela a seguir resume as regras de uso de maiúsculas e minúsculas para identificadores e fornece exemplos para os diferentes tipos de identificadores.
Identificador |
Case |
Exemplo |
|---|---|---|
Classe |
Pascal |
AppDomain |
Tipo de enumeração |
Pascal |
ErrorLevel |
Valores de enumeração |
Pascal |
FatalError |
Evento |
Pascal |
ValueChanged |
Classe de exceção |
Pascal |
WebException |
Campo somente leitura estático |
Pascal |
RedValue |
Interface |
Pascal |
IDisposable |
Método |
Pascal |
ToString |
Namespace |
Pascal |
System.Drawing |
Parâmetro |
Camel |
typeName |
Propriedade |
Pascal |
BackColor |
Regras de uso de maiúsculas e minúsculas para acrônimos
Um acrônimo é uma palavra que é formada das letras das palavras em um termo ou frase. Por exemplo, o HTML é o acrônimo de Hypertext marcação linguagem. Você deve incluir acrônimos identificadores quando forem amplamente conhecidas e bem compreendidas. Acrônimos diferem dos abreviações, uma abreviação reduz uma única palavra. Por exemplo, ID é uma abreviação de identifier. Em geral, os nomes da biblioteca não devem usar abreviações.
.gif "Observação") Observação: |
|---|
São as duas abreviações que podem ser usadas em identificadores ID e OK. Em casos Pascal identificadores que elas devem aparecer sistema autônomo Id, e Ok. Se usado sistema autônomo a primeira palavra em um identificador de casos camel, eles devem aparecer sistema autônomo id e ok, respectivamente. |
Uso de maiúsculas e minúsculas de acrônimos depende do tamanho do acrônimo. Todos os acrônimos estão pelo menos dois caracteres. Para fins dessas diretrizes, se um acrônimo for exatamente dois caracteres, ele é considerado um acrônimo curto. Um acrônimo de três ou mais caracteres é um acrônimo longo.
As diretrizes a seguir especificam a maiúsculas e minúsculas adequada para curtos e longos acrônimos. As regras de diferenciação de maiúsculas e minúsculas do identificador têm precedência sobre acrônimo regras de diferenciação de maiúsculas e minúsculas.
colocar em maiúsculas os dois caractere de dois caractere acrônimos, exceto a primeira palavra de um identificador de casos camel.
Uma propriedade chamada DBRate é um exemplo de um (acrônimo curtoDB) usado sistema autônomo a primeira palavra de um identificador de casos do Pascal. Um parâmetro chamado ioChannel é um exemplo de um (acrônimo curtoIO) usado sistema autônomo a primeira palavra de um identificador de casos camel.
colocar em maiúsculas somente o primeiro caractere de acrônimos com três ou mais caracteres, exceto a primeira palavra de um identificador de casos camel.
Uma classe chamada XmlWriter é um exemplo de um longo acrônimo usado sistema autônomo a primeira palavra de um identificador de casos camel. Um parâmetro chamado htmlReader é um exemplo de um longo acrônimo usado sistema autônomo a primeira palavra de um identificador de casos camel.
Não colocar em maiúsculas os caracteres de qualquer acrônimos, seja qual for seu comprimento no início de um identificador causado camel.
Um parâmetro chamado xmlStream é um exemplo de uma (acrônimo longoxml) usado sistema autônomo a primeira palavra de um identificador de casos camel. Um parâmetro chamado dbServerName é um exemplo de um (acrônimo curtodb) usado sistema autônomo a primeira palavra de um identificador de casos camel.
Regras de uso de maiúsculas e minúsculas para composta de palavras e termos comuns
Não colocar em maiúsculas cada palavra em chamados palavras compostas formulário fechado.Esses são palavras compostas escritas sistema autônomo uma única palavra, sistema autônomo o "ponto de extremidade".
Por exemplo, hashtable é uma palavra composta formulário fechado que deve ser tratada sistema autônomo uma única palavra e casos de forma adequada. No caso do Pascal, ele é Hashtable; em camel case é hashtable. Para determinar se uma palavra é uma palavra composta de forma fechada, verifique um dicionário corrente.
A lista a seguir identifica alguns termos comuns que não são palavras compostas formulário fechado. A palavra é mostrada na Pascal casing seguido pelo formulário causado camel em parênteses.
BitFlag (bitFlag)
FileName (fileName)
LogOff (logOff)
LogOn (logOn)
SignIn (signIn)
SignOut (signOut)
UserName (userName)
WhiteSpace (whiteSpace)
Com diferenciação de maiúsculas e minúsculas
As diretrizes de uso de maiúsculas e minúsculas existem unicamente para tornar mais fácil de ler e reconhecer identificadores. Uso de maiúsculas e minúsculas não pode ser usado sistema autônomo um meio de evitar conflitos de nome entre elementos de biblioteca.
Não assuma que todas as linguagens de programação diferenciam diferenciar maiúsculas de minúsculas.Eles não são.Nomes não podem diferir por caso sozinho.
Partes direitos autorais 2005 Microsoft Corporation. Todos os direitos reservados.
Partes direitos autorais Addison-Wesley Corporation. Todos os direitos reservados.
Para obter mais informações sobre diretrizes de design, consulte a "diretrizes de design do estrutura: Catálogo de convenções, idiomas e padrões para bibliotecas do .NET reutilizável"Krzysztof Cwalina e Brad Abrams, publicado pela Addison-Wesley, 2005.
Consulte também
Outros recursos
Diretrizes de Design para desenvolvimento bibliotecas de classe