CA1709: Gli identificatori devono essere digitati correttamente con distinzione tra maiuscole e minuscole

Articolo	Valore
ID regola	CA1709
Category	Microsoft.Naming
Modifica	Interruzione: quando viene generata su assembly, spazi dei nomi, tipi, membri e parametri. Non di rilievo: quando viene attivato su parametri di tipo generico.

Causa

Il nome di un identificatore non viene tra maiuscole e minuscole correttamente.

- oppure -

Il nome di un identificatore contiene un acronimo a due lettere e la seconda lettera è minuscola.

- oppure -

Il nome di un identificatore contiene un acronimo di tre o più lettere maiuscole.

Descrizione regola

Le convenzioni di denominazione forniscono un aspetto comune per le librerie destinate a Common Language Runtime. Questa coerenza riduce la curva di apprendimento necessaria per le nuove librerie software e aumenta la fiducia dei clienti che la libreria è stata sviluppata da qualcuno che ha esperienza nello sviluppo di codice gestito.

Per convenzione, i nomi dei parametri usano maiuscole e minuscole camel e nomi, tipo e nomi dei membri usano la combinazione di maiuscole e minuscole Pascal. In un nome camel-cased, la prima lettera è minuscola e la prima lettera di tutte le parole rimanenti nel nome è maiuscola. Esempi di nomi con maiuscole e minuscole camel sono packetSniffer, ioFilee fatalErrorCode. In un nome con maiuscole/minuscole Pascal, la prima lettera è maiuscola e la prima lettera di tutte le parole rimanenti nel nome è maiuscola. Esempi di nomi con maiuscole e minuscole Pascal sono PacketSniffer, IOFilee FatalErrorCode.

Questa regola suddivide il nome in parole basate sulla combinazione di maiuscole e minuscole e controlla le parole di due lettere rispetto a un elenco di parole comuni a due lettere, ad esempio "In" o "My". Se non viene trovata una corrispondenza, si presuppone che la parola sia un acronimo. Inoltre, questa regola presuppone che abbia trovato un acronimo quando il nome contiene quattro lettere maiuscole in una riga o tre lettere maiuscole in una riga alla fine del nome.

Per convenzione, gli acronimi a due lettere usano tutte le lettere maiuscole e gli acronimi di tre o più caratteri usano maiuscole e minuscole Pascal. Gli esempi seguenti usano questa convenzione di denominazione: 'DB', 'CR', 'Cpa' e 'Ecma'. Gli esempi seguenti violano la convenzione: 'Io', 'XML' e 'DoD', e per i nomi non di parametro, 'xp' e 'cpl'.

'ID' è caso speciale per causare una violazione di questa regola. 'ID' non è un acronimo bensì l'abbreviazione di 'identification'.

Come correggere le violazioni

Modificare il nome in modo che venga maiuscole/minuscole correttamente.

Quando eliminare gli avvisi

È possibile eliminare questo avviso in caso di convenzioni di denominazione personalizzate o se l'identificatore rappresenta un nome appropriato, ad esempio il nome di una società o di una tecnologia.

È anche possibile aggiungere termini, abbreviazioni e acronimi specifici a un dizionario personalizzato di analisi del codice. I termini specificati nel dizionario personalizzato non causeranno violazioni di questa regola. Per altre informazioni, vedere Procedura: Personalizzare il dizionario di analisi del codice.

Regole correlate

CA1708: Gli identificatori non si devono differenziare solo in base alle maiuscole e minuscole