Summary is not showing in the assembly if it is added as a reference

风格不统一 提交于 2019-12-03 08:08:34

问题


I've created a 'Class Library' in C#, which has many functions with summary (XML documentation comments).

For example

///<summary>
///Adds the two numbres
///</summary>
public void Add()
{
    //statements
}

if i use the function in the same namespace , its showing the summary, but if i added it as reference in some ohter workspace(solution) its not showing the summary.

How to make it visible i other solutions if a added it as a reference, and wat may be the reason for this?


回答1:


You need to generate XML documentation for the assembly (a file named myassembly.xml) and copy it alongside your .dll where it's referenced by your other projects. See this page in MSDN for instructions.




回答2:


  1. Go to the solution explorer of your source code. Right click on the project name and go the properties.
  2. go to the Build tab if you are using c# and select the check box Xml documentation file.
  3. When you build your source code the Xml file will be generated in the location where your dll is present.
  4. while copy your dll to the solution copy the xml file and paste into the bin of your destination solution.



回答3:


When you compile classes that have xml comment, normally a .xml file is created. (check the options in Visual Studio)

When you add a reference to such an assembly, make sure the XML file is present. The documentation is not contained within the assembly but within the xml file.



来源:https://stackoverflow.com/questions/6476915/summary-is-not-showing-in-the-assembly-if-it-is-added-as-a-reference

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