Regole di denominazione

  • Articolo

Le regole di denominazione supportano la conformità alle convenzioni di denominazione delle linee guida per la progettazione di .NET.

Contenuto della 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.
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.
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.
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 tipi derivati da questi tipi hanno un suffisso associato al tipo o all'interfaccia di base.
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.
CA1712: Non usare nomi di tipo come prefisso nei valori di enumerazione I nomi dei membri di enumerazione non sono preceduti dal nome del tipo perché è previsto che le informazioni sul tipo vengano fornite dagli strumenti di sviluppo.
CA1713: Non usare 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 ha l'attributo System.FlagsAttribute e il relativo nome non termina in "s". I tipi contrassegnati con FlagsAttribute hanno nomi plurali perché l'attributo indica che è possibile specificare più di un valore.
CA1715: Gli identificatori devono contenere il prefisso corretto Il nome di un'interfaccia visibile esternamente non inizia con una maiuscola "I". Il nome di un parametro di tipo generico in un tipo o metodo visibile esternamente non inizia con un maiuscolo "T".
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.
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.
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.
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. I metodi "Get" e le proprietà devono avere nomi indicano chiaramente la distinzione tra le funzioni.
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 .NET. La violazione di questa regola può ridurre l'usabilità della libreria.
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.
CA1727: Usare PascalCase per i segnaposto denominati Usare PascalCase per i segnaposto denominati nel modello di messaggio di registrazione.