Condividi tramite

Regole della documentazione

  • Articolo

Le regole della documentazione supportano la scrittura di librerie ben documentate tramite l'uso corretto dei commenti della documentazione XML per le API visibili esternamente.

In questa sezione

Regola Descrizione
CA1200: evitare di usare tag cref con un prefisso L'attributo cref in un tag di documentazione XML significa "riferimento al codice". Specifica che il testo interno del tag è un elemento di codice, ad esempio un tipo, un metodo o una proprietà. Evitare di usare tag cref con prefissi, perché impedisce al compilatore di verificare i riferimenti. Impedisce inoltre all'ambiente di sviluppo integrato (IDE) di Visual Studio di trovare e aggiornare questi riferimenti a simboli durante il refactoring.