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.
«dicembre»
domlunmarmergiovensab
24252627282930
1234567
891011121314
15161718192021
22232425262728
2930311234