9得票2回答
通过LINQ to SQL设计器生成的类属性添加XML注释

我使用Visual Studio中的LINQ to SQL设计器创建了一个数据库对象模型。现在,我想为每个生成的属性添加XML注释,但我不知道如何在不刷新dbml文件时完成此操作。 如何实现这一目标?

17得票2回答
XML注释中的<list>在IntelliSense中未显示

我正在尝试让VB.NET的XML注释与IntelliSense配合使用,也许它的工作方式不是我想象的那样。 ''' &lt;summary&gt; ''' Gets or sets the Patient Code. ''' &lt;list type="bullet"&...

9得票1回答
有没有办法在C# XML注释中保留空格?

我目前正在记录我的C#代码,并且希望能够包含一个直接显示如何调用代码的代码块。我使用嵌入到摘要中的 &lt;code&gt; 标签: 虽然这种方式在一般情况下是有效的,但我想保留空格(换行符、缩进)。我迄今为止尝试过以下方法: 对 &lt;code&gt; 标签应用了 xml:spa...

14得票5回答
你应该在私有方法上编写XML注释吗?

因此,我在我的代码中使用XML注释来帮助解释公共方法和公共成员。另一位开发人员提到我的部分方法没有XML注释。我的规则是:如果是public或protected,则添加XML注释;如果是private,则不添加。这个规则听起来合理吗?或者有什么原因需要对私有方法添加XML注释吗?

21得票6回答
将.Net XML注释转换为API文档

有没有一种简单的方法可以从Visual Studio XML输出中生成MSDN风格的文档? 我不太耐心去设置好它的xslt,因为我知道我不是第一个遇到这个问题的人。 另外,我最近尝试了一下安装Sandcastle,但是它真的让我晕头转向。要么是在整个过程中我错过了一些重要东西,要么就是它涉及...

15得票1回答
在XML文档中使用< >字符的see cref用法?

可能是重复问题: 如何在XML文档中引用泛型类和泛型方法 我一直在使用 see cref 标签,它非常好用,但现在我需要在 see cref 中包含一个字符串数组的泛型列表,但是文档没有正确呈现。 /// &lt;returns&gt;A &lt;see cref="Li...

8得票14回答
代码文档:太多是否有害?

.NET源代码中文档的数量应该是多少? 背景:我继承了一个庞大的代码库,我在SO上发布的一些其他问题中已经提到过。这个代码库的一个“特点”是上帝类(God Class)——一个单一的静态类,包含超过3000行代码,涵盖几十个静态方法,它们从Utilities.CalculateFYBased...

9得票9回答
代码注释:你把代码注释放在接口上还是具体类上,或者两者都有?

如何最好地记录类和接口。假设您有一个名为Foo的具体类,它派生自名为IFoo的接口。您在哪里放置方法的注释?您是否需要在接口和具体类上重复注释? 以下是注释被复制的示例: public class Foo : IFoo { /// &lt;summary&gt; /// T...

50得票5回答
C# XML /// 注释中,<returns></returns> 标签出现在哪里?

我是一名编程学生,我的问题很简单,但网上找不到答案。这里是我的问题: 在C#的XML注释中,&lt;returns&gt;标签显示在哪里?我知道&lt;summary&gt;标签中包含的所有内容都会在您悬停鼠标在方法调用上时出现在智能感知中,但返回标记却没有。 那么&lt;returns&...

19得票4回答
VS2010:自动生成文件和XML文档说明

这实际上只是重新提问有关Visual Studio 2008的此问题。 VS2010是否提供任何功能来消除自动生成代码的CS1591编译器警告? CS1591:公开可见类型或成员缺少XML注释 引用VS2008的问题: 这只是一个烦恼而不是问题。 我的项目包含许多自动生成的文件(使用mg...