Condividi tramite


Avvisi di denominazione

Gli avvisi di denominazione supportano la conformità alle convenzioni di denominazione delle linee guida di progettazione di .NET Framework.

In questa sezione

Regola

Descrizione

CA1700: Non denominare 'Reserved' i valori di enumerazione

Questa regola presuppone che un membro di enumerazione con un nome che contiene la parola "reserved" non sia attualmente utilizzato, ma sia un segnaposto che dovrà essere rinominato o rimosso in una versione futura. La ridenominazione o rimozione di un membro è ritenuta una modifica sostanziale.

CA1713: Non utilizzare il prefisso Before o After negli eventi

Il nome di un evento inizia con "Before" o "After". Per denominare eventi correlati generati in una sequenza specifica, utilizzare i tempi verbali presente o passato per indicare la posizione relativa nella sequenza di azioni.

CA1714: Le enumerazioni con Flags devono avere nomi plurali

Un'enumerazione pubblica dispone dell'attributo System.FlagsAttribute e il nome non termina per "s". Ai tipi contrassegnati con FlagsAttribute sono assegnati nomi plurali perché tale attributo indica che è possibile specificare più valori.

CA1704: Gli identificatori devono essere digitati correttamente

Il nome di un identificatore visibile esternamente contiene una o più parole che non sono riconosciute dalla libreria del correttore ortografico Microsoft.

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

Gli identificatori per spazi dei nomi, tipi, membri e parametri non possono differire solo in base a maiuscole e minuscole poiché ai linguaggi destinati a Common Language Runtime non è richiesta la distinzione tra maiuscole e minuscole.

CA1715: Gli identificatori devono contenere il prefisso corretto

Il nome di un'interfaccia visibile esternamente non inizia con una "I" maiuscola. Il nome di un parametro di tipo generico su un tipo o metodo visibile esternamente non inizia con una "T" maiuscola.

CA1720: Gli identificatori non devono contenere nomi di tipo

Il nome di un parametro in un membro visibile esternamente contiene un nome di tipo di dati oppure il nome di un membro visibile esternamente contiene un nome di tipo di dati specifico del linguaggio.

CA1722: Gli identificatori non devono contenere il prefisso non corretto

Per convenzione, solo determinati elementi di programmazione presentano nomi che iniziano con un prefisso specifico.

CA1711: Gli identificatori non devono contenere un suffisso non corretto

Per convenzione, solo i nomi dei tipi che estendono determinati tipi di base o che implementano determinate interfacce o dei tipi derivati da questi tipi devono terminare con suffissi specifici riservati. Gli altri nomi di tipi non devono utilizzare questi suffissi riservati.

CA1717: Solo le enumerazioni con FlagsAttribute devono avere nomi plurali

In base alle convenzioni di denominazione, un nome plurale in un'enumerazione indica che è possibile specificare più valori di enumerazione contemporaneamente.

CA1725: I nomi dei parametri devono corrispondere alla dichiarazione di base

Una denominazione coerente dei parametri in una gerarchia di override aumenta la funzionalità degli override di metodo. Un nome di parametro in un metodo derivato diverso dal nome nella dichiarazione di base può provocare confusione sulla natura del metodo, ovvero se si tratta di un override del metodo di base o di un nuovo overload del metodo.

CA1719: I nomi dei parametri non devono corrispondere ai nomi dei membri

Un nome di parametro deve comunicare il significato di un parametro e un nome di membro deve comunicare il significato di un membro. Le progettazioni in cui questi nomi coincidono sono rare. Assegnare a un parametro lo stesso nome del relativo membro non è intuitiva e rende più complesso l'utilizzo della libreria.

CA1701: Le parole composte di una stringa di risorsa devono essere digitate correttamente con distinzione tra maiuscole e minuscole

Ogni parola nella stringa di risorsa è suddivisa in token basati sulla distinzione tra maiuscole e minuscole. Ogni combinazione di due token contigui viene controllata in base alla libreria del correttore ortografico Microsoft. Se riconosciuta, la parola produce una violazione della regola.

CA1703: Le stringhe di risorsa devono essere digitate correttamente

Una stringa di risorsa contiene una o più parole che non sono riconosciute dalla libreria del correttore ortografico Microsoft.

CA1724: I nomi dei tipi non devono corrispondere agli spazi dei nomi

I nomi dei tipi non devono corrispondere ai nomi degli spazi dei nomi definiti nella libreria di classi .NET Framework. La violazione di questa regola può ridurre l'utilizzabilità della libreria.

CA1707: Gli identificatori non devono contenere caratteri di sottolineatura

Per convenzione i nomi degli identificatori non contengono il carattere di sottolineatura (_). In base a questa regola vengono controllati spazi dei nomi, tipi, membri e parametri.

CA1721: I nomi delle proprietà non devono corrispondere ai metodi get

Il nome di un membro pubblico o protetto inizia con "Get" e corrisponde in altro modo al nome di una proprietà pubblica o protetta. " Le proprietà e i metodi "Get" devono avere nomi che distinguano chiaramente la loro funzione.

CA1716: Gli identificatori non devono corrispondere a parole chiave

Un nome di spazio dei nomi o di tipo corrisponde a una parola chiave riservata in un linguaggio di programmazione. Gli identificatori di spazi dei nomi e tipi non devono corrispondere a parole chiave definite dai linguaggi con destinazione Common Language Runtime.

CA1726: Utilizzare termini preferiti

Il nome di un identificatore visibile esternamente include un termine per il quale esiste un termine alternativo preferito. In alternativa, il nome include il termine "Flag" o "Flags".

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

Per convenzione i nomi di parametro sono basati sulla convenzione Camel, mentre i nomi di spazio dei nomi, tipo e membro utilizzano la convenzione Pascal.

CA1702: Le parole composte devono essere digitate correttamente con distinzione tra maiuscole e minuscole

Il nome di un identificatore contiene più parole, fra cui almeno una che sembra essere composta e digitata in modo non corretto con distinzione tra maiuscole e minuscole.

CA1712: Non utilizzare nomi di tipo come prefisso nei valori di enumerazione

I nomi dei membri di enumerazione non hanno come prefisso il nome del tipo poiché si prevede che le informazioni sul tipo vengano fornite dagli strumenti di sviluppo.

CA1710: Gli identificatori devono contenere il suffisso corretto

Per convenzione i nomi dei tipi che estendono determinati tipi di base o che implementano determinate interfacce o dei tipi derivati da questi tipi contengono un suffisso associato al tipo di base o all'interfaccia.