11得票1回答
使用Doxygen为已存在的C#代码创建带有XML注释的文档

我已经到处都看到了,Doxygen是为C#代码生成文档的最佳选择。我要先记录下单个接口(踏出第一步),它已经有了XML注释(///)。 由于有大量帖子和信息可用(包括doxygen.org)表明这些注释已被支持,当我运行doxywizard时,我会收到“警告:未记录复合公司::产品::我的接...

11得票1回答
在VS2015CE中,<para></para>和<para />会显示额外的空白行,无法去除。

当我在Visual Studio 2015 Community Edition的文档中使用&lt;para&gt;&lt;/para&gt;标签(以&lt;para /&gt;形式出现),在 IntelliSense 工具提示中会显示多一个空白行(在输入成员名称时出现)。 我尝试了许多变量,包...

11得票1回答
如何在使用XSD.exe生成的C#类中包含xsd:documentation?

我正在使用xsd.exe从一组xsd文件中生成一个C#类。 Xsd文件使用&lt;xsd:documentation&gt;标签包括有用的描述信息。例如:&lt;xsd:complexType name="AddressType"&gt; &lt;xsd:annotation&gt; ...

10得票2回答
如何在C#的XML文档注释中链接到MSDN/官方文档?

假设有一个类的XML注释如下:///&lt;summary&gt;Handles the AuthenticateRequest event in the ASP.NET page request lifecycle to authenticate users.&lt;/summary&gt;...

10得票1回答
如何在方法的XML文档中引用其他类型的成员?

我在一个方法中有以下XML文档段: /// &lt;summary&gt; /// Calculates the total charge for hours between the &lt;see cref="StartDateTime"/&gt; and &lt;see cr...

10得票5回答
C#中//和///的区别

当我输入///时,Visual Studio会显示出一些参数,如下所示:/// &lt;summary&gt; /// /// &lt;/summary&gt; /// &lt;param name="sender"&gt;&lt;/param&gt; /// &lt;param name=...

10得票2回答
Delphi中的XML注释中的<see>标签在哪些情况下实际起作用?

我想知道这些 XML 引用是如何工作的,我不明白为什么它们起作用或者不起作用,而且我也没有找到关于这方面的任何信息。 以下是一个例子:type TOuterClass= class strict private type TLogger = class ...

10得票1回答
在Azure云服务包中包含生成的XML文档

编辑:更新说明,该问题仅在打包Azure云服务CSPKG文件时出现。 我有一个ASP.NET Web API 2应用程序,作为Azure云服务解决方案中的Web角色。我想使用Web API帮助页面并利用生成的XML文档填充它们。我遇到了困难,无法弄清楚如何将XML文档包含在Web Api项目...

10得票1回答
为ValueTuple中的命名元素添加XML文档注释。

使用 C# 7 中的 ValueTuple,现在可以编写返回或消耗复合对象的方法和属性而不需要显式声明类型。但是,如果未提供文档,这些命名元组可能会造成困惑。 因为文档库的主要和最方便的方式是使用 XML 文档,所以有没有一种使用 XML 文档来提供命名元组中变量描述的方法呢? 我知道显而...

10得票1回答
DocFX:为多个项目生成API文档

我正在处理一个解决方案中包含多个项目的项目。我想从外部目录生成文档,以保持应用程序代码文件夹的清洁。当我尝试在docfx.json中设置src目录时,它似乎不喜欢绝对路径,也不喜欢相对路径。{ "metadata": [{ "src": [{ ...