Usualmente, in tutti i miei progetti, attivo la generazione automatica del file XML che recupera automaticamente i commenti XML generati nel codice creando un file adatto per la documentazione. L'attivazione fa in modo che vengano prodotti dei Warning che indicano che ci siamo dimenticati i commenti sui metodi e sulle proprietà pubbliche delle classi del progetto, questo è utile per ricordarci di mettere i commenti nelle nostre librerie, può rivelarsi invece una noia quando si attiva su un progetto contenente dei Dataset, infatti, il wizard che genera il codice per i Dataset Tipizzati, non mette i commenti e quindi da origine ad una lunga serie di Warnings che possono oscurare e rendere di non facile leggibilità l'elenco dei veri errori e warning del programma.
Pertanto, in questi casi si può disattivare la generazione del warning specifico fino a che il debug è completato ed eventualmente riattivarlo quando si controlla di aver inserito tutta la documentazione.
Come si sopprime un Warning? Nelle proprietà del progetto:
Configuration Properties; Build proprietà: Suppress Specific Warnings indicare i numeri dei Warnings da eliminare in elenco separato da punti e virgola.
Il warning incriminato, che elimina il messaggio sull'assenza di commenti XML per membri pubblici delle classi è il numero 1587.
Tags: VisualStudio