¿Cómo pueden persistir los comentarios XML del código fuente de .NET en los metadatos del conjunto?

Question

¿Ha notado que para algunos métodos en los ensamblajes del sistema, el .NET Reflector también muestra la documentación correspondiente? Lo que significa que la documentación puede persistir en los metadatos del conjunto.

¿Cómo puedo hacer que funcione para mis propios ensamblajes? Es decir, quiero ver mis comentarios a mi método cuando lo refleje en el .NET Reflector.

Gracias.

Answer 1

Los comentarios de documentos XML no se conservan en los metadatos del ensamblaje. De hecho, Visual Studio y otras herramientas como Reflector localizan los comentarios de documentos XML mediante la búsqueda a través de un conjunto de rutas conocidas que contienen archivos de comentarios de documentos XML.

Si desea ver la documentación XML para sus propios ensamblajes, asegúrese de que el archivo XML esté en el mismo directorio que el ensamblado al que se hace referencia, y comparta el mismo nombre que el ensamblado (menos la extensión). Por ejemplo, MyAssembly.Namespace.XML corresponde al ensamblado de MyAssembly.Namespace.dll .

Vea Cómo ver los comentarios XML del código de Reflector para más información.