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 @ Wednesday, January 26, 2011 4:13 PM

Print
Comments have been closed on this topic.
«January»
SunMonTueWedThuFriSat
2930311234
567891011
12131415161718
19202122232425
2627282930311
2345678