.net - not - ¿Dónde obtiene Visual Studio la información de descripción de tipo utilizada por Intellisense?
intellisense visual studio code (5)
¿De dónde vienen las descripciones de tipo / miembro / parámetro que ves en la burbuja Intellisense? ¿Están almacenados en atributos de tipo?
EDITAR: Estoy específicamente interesado en los tipos incorporados.
.Net Framework proporciona un archivo de documentación XML para los ensamblados enviados. El IDE lee estos archivos de documentación para obtener las descripciones y la información sobre herramientas para los tipos incorporados.
Esta documentación se almacena típicamente, pero no siempre, en un subdirectorio del marco en todos los puntos. Por ejemplo, en mi máquina, los archivos se almacenan en el directorio C: / windows / microsoft.net / framework / v2.0.50727 / en.
Hay un archivo XML por ensamblaje enviado en el marco.
Aunque si sus clases están compiladas y no desea publicar el código fuente, puede que necesite crear un archivo de esquema XML y colocarlo aquí. No estoy seguro de la estructura, pero tengo un poke alrededor y verás lo que quiero decir.
[unidad de instalación] / Archivos de programa (x86) / Microsoft Visual Studio 9.0 / Xml / Schemas
Estoy de acuerdo con Joel Coehoorn. Puede echarle un vistazo al MSDN para este tema: http://msdn.microsoft.com/en-us/library/b2s063f7.aspx
También hay un excelente artículo sobre el proyecto de código con muchas explicaciones, ejemplos, un instructivo cuando desea crear una documentación para su clase sin publicar el código fuente completo y una lista completa de todas las etiquetas estándar que puede usar ( puede defina sus propias etiquetas también, solo asegúrese de leerlas con su herramienta de documentación, por ejemplo, castillos de arena ).
Artículo sobre el proyecto de código: http://www.codeproject.com/KB/XML/csharpcodedocumentation.aspx
No sé sobre los tipos incorporados, pero cuando construyes tus propias clases puedes usar comentarios Xml para listar la información intellisense. Los comentarios se guardan en su propio archivo xml al compilar el proyecto y, siempre que ese archivo esté en el lugar correcto, Visual Studio podrá usarlo. No solo eso, sino que obtendrás ayuda de intellisense para construir los comentarios. Para C #, simplemente agregue un extra / carácter a una línea de comentario justo encima de una clase, propiedad o método: ///. Para VB, usa dos caracteres extra: '''' ''
Una advertencia con esto (y estoy seguro de que hay una opción en algún lugar para controlarlo), pero mi experiencia es que una vez que pones un comentario xml en cualquier parte de un proyecto, obtienes una advertencia de compilación para cada elemento público que no está Ha comentado si no los usa en todas partes del proyecto.
también busque en el archivo DotNetConfig.xsd, que generalmente se encuentra en el directorio de instalación de Visual Studio 8 (o 9) en el subdirectorio Xml / Schemas.