xml-comments

9calore

9risposta

Commentare il codice: metti i tuoi commenti di codice su Interfacce o su classi Concrete o entrambi?

Qual è la migliore pratica nella documentazione di classi e interfacce. Di 'se hai una classe concreta chiamata Foo, che deriva da un'interfaccia chiamata IFoo. Dove metti i tuoi commenti per i tuoi m

6calore

1risposta

Sandcastle/SHFB. Aggiungi le icone della piattaforma e le informazioni sulla versione per aiutare le pagine del file

Sto costruendo un file di aiuto per la mia libreria usando il Generatore di file di aiuto di Sandcastle. La libreria ha tre versioni (.NET, Silverlight e Windows Phone 7) create dalla stessa base di c

16calore

2risposta

web.config: porre un commento all'interno attributi XML

voglio mettere un commento nel file di web.config, qualcosa di simile: <httpRuntime requestValidationMode="2.0" // require for [ValidateInput(false)] in .net-4.0 requestPathInvalidCharacter

23calore

3risposta

Può ConfigurationManager conservare i commenti XML su Save()?

Ho scritto una piccola utility che mi permette di cambiare un semplice appSetting per il file App.config di un'altra applicazione, e quindi salvare le modifiche: //save a backup copy first. var cfg =

6calore

3risposta

Come inserire automaticamente commenti in .NET?

Mi piacerebbe avere un singolo comando per auto-linearizzare i commenti in stile XML in .NET. Esempio: /// <summary> /// This comment line should be /// on one line, and other lines in this <summary

8calore

1risposta

utilizzando see cref con i caratteri < > nella documentazione XML?

Eventuali duplicati: How to reference generic classes and methods in xml documentation Sono stato con il tag cref vedere e funziona benissimo, ma ora ho bisogno di includere un elenco generico di stri

6calore

1risposta

XML commenti non appaiono nelle servizio WCF

Ho un servizio WCF e commentando i miei contratti di gestione, come di seguito: /// <summary> /// Call to topup a card. /// </summary> /// <param name="topUp">The TopUp object which spe

18calore

4risposta

VS2010: file generati automaticamente e documentazione XML

Questo è davvero solo ri-chiedere this question asked about Visual Studio 2008. VS2010 offre funzionalità per eliminare l'avviso del compilatore CS1591 per il codice generato automaticamente? CS1591:

6calore

3risposta

Suggerimenti per la documentazione di classe

Siamo un negozio Microsoft, concentrato sull'utilizzo di C#. Abbiamo diversi progetti, inclusi siti Web, servizi Windows e librerie di classi, che incorporano commenti XML. Sto cercando di generare un

6calore

1risposta

tipo generico costruito in parte CREF di xml-commento

ho classe di eccezione generica come questa: public class DuplicateException<TEntity> : Exception { public TEntity Entity { get; set; } } E devo metodo non generico che potrebbe gettare costr