Visual Studio: Missing XML comment for publicly visible type or member…

Sto partecipando allo sviluppo del nuovo MES da utilizzare nell’azienda nella quale lavoro. Volendo pian piano documentare per lo meno il dominio abbiamo attivato la compilazione delle References.

Questo ha però portato al problema opposto: tutte le funzioni non ancora commentate emettono un warning del tipo:

Missing XML comment for publicly visible type or member […]

Dopo un veloce giro in rete ho trovato queste possibilità:

  1. 1. Completare la fase di documentazione (non attuabile al momento)
  2. 2. Disabilitare la generazione della documentazione (un peccato per il lavoro già fatto ed uno sprono a completarlo)
  3. 3. Disabilitare i warning di questo tipo (1591)
  4. 4. Usare “#pragma warning disable 1591” e#pragma warning restore 1591” all’inizio e alla fine del codice da escludere (non pratico nel caso di un dominio con tante classi)
  5. 5. Ignorare i Warnings (cattiva idea, perché qualche warning è invece interessate)

Se avete il mio stesso problema consiglio il metodo 3, andando sull’apposito tab del progetto.

image

posted @ mercoledì 26 gennaio 2011 18:13

Print
Comments have been closed on this topic.
«aprile»
domlunmarmergiovensab
31123456
78910111213
14151617181920
21222324252627
2829301234
567891011