Embedding Intellisense Xml Documentation in Assembly?

感情迁移 提交于 2019-12-09 14:21:42

问题


I have an assembly containing very thorough XML-based documentation, which is used through Sandcastle to generate the help-files for the product. We also use the output XML files for providing proper Intellisense in Visual Studio when programmers use the assembly obviously.

In order to do this, it seems we have do both supply the user with the assembly ("assembly.dll") and the documentation ("assembly.xml").

Is it somehow possible to embed the documentation within the assembly, so we'd only have to supply the single assembly-file and Visual Studio would be able to extract the information? Maybe embedded as a resource or something like that?


回答1:


Unfortunately you will need to supply both as Visual Studio only knows to look at XML documents for Intellisense.




回答2:


If you search C:\Windows\Microsoft.NET\Framework\v2.0.50727 you will find that all of the .net assemblies you may be referencing in your applications are using the xml files. Visual studio will only provide intellisense for assemblies if the xml file exists. For example, if you were to close Visual Studio, then remove the System.Drawing.xml file and then reopen VS, there should not be any intellisense for that assembly. You would then need to close VS, copy it back, and then reopen VS for the intellisense to work again.




回答3:


Am i missing something? I always comment as usual (using 3 slashes or 3 tick marks (vb)), use the built in xml tags and when i use the assembly i get the intellisense - i rarely use an extrernal xml file.



来源:https://stackoverflow.com/questions/200920/embedding-intellisense-xml-documentation-in-assembly

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!