¿Incrustar documentación Xml de Intellisense en Ensamblado?


Tengo un ensamblado que contiene documentación muy completa basada en XML, que se utiliza a través de Sandcastle para generar los archivos de ayuda para el producto. También utilizamos los archivos XML de salida para proporcionar Intellisense adecuado en Visual Studio cuando los programadores utilizan el ensamblaje obviamente.

Para hacer esto, parece que tenemos que suministrar al usuario el ensamblado ("ensamblado.dll") y la documentación ("assembly.XML").

¿ Es posible incrustar la documentación? dentro del ensamblado, por lo que solo tendríamos que suministrar el único archivo ensamblado y Visual Studio sería capaz de extraer la información? ¿Tal vez incrustado como un recurso o algo así?

Author: starblue, 2008-10-14

3 answers

Desafortunadamente, tendrá que proporcionar ambos, ya que Visual Studio solo sabe mirar documentos XML para Intellisense.

 13
Author: Jason Whitehorn,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2008-10-14 15:17:27

Si busca C:\Windows\Microsoft.NET\Framework\v2.0.50727 encontrará que todos los ensamblados. net a los que puede hacer referencia en sus aplicaciones están utilizando los archivos xml. Visual studio solo proporcionará intellisense para ensamblados si el archivo xml existe. Por ejemplo, si va a cerrar Visual Studio, elimine el sistema.Dibujo.archivo xml y luego vuelva a abrir VS, no debe haber ningún intellisense para ese ensamblaje. A continuación, tendría que cerrar VS, copiarlo de nuevo, y luego volver a abrir VS para que el intellisense funcione de nuevo.

 5
Author: ,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2008-10-30 22:30:20

¿Me estoy perdiendo algo? Siempre comento como de costumbre (usando 3 barras o 3 marcas de verificación (vb)), uso las etiquetas xml incorporadas y cuando uso el ensamblado obtengo el intellisense - rara vez uso un archivo xml extrernal.

 1
Author: schmoopy,
Warning: date(): Invalid date.timezone value 'Europe/Kyiv', we selected the timezone 'UTC' for now. in /var/www/agent_stack/data/www/ajaxhispano.com/template/agent.layouts/content.php on line 61
2008-10-14 23:32:24