14得票1回答
在代码注释中引用TFS工作项

在Visual Studio(2012+)中,我希望能够从代码注释中点击到TFS工作项的引用。 是否有简单的方法可以实现这一点,并且是否还可以从函数体内部的注释中实现(不是函数的摘要)? 所以我想要类似这样的效果:/// <summary> /// Example of a su...

8得票1回答
XML注释未在WCF服务中显示

我有一个WCF服务,以下是我的操作合同的注释: /// <summary> /// Call to topup a card. /// </summary> /// <param name="topUp">The TopUp...

7得票3回答
在Vb.Net中自动生成XML注释

最近我从c#.net转向vb.net进行编码。 在c#中,我可以在任何类/方法上方按下///,Visual Studio会自动为我生成xml注释内容。 例如: /// <summary> /// /// </summar...

7得票1回答
Visual Studio 2010 SDK -- 如何在XML注释组旁边放置修饰?

我在寻找如何获取XML注释的NormalizedSnapshotSpanCollection,但是Visual Studio SDK参考文档并没有提供很好的帮助。 我想在这些注释旁边放置一个图标... 我不想在每一行旁边都放一个图标,而只想在每个组的第一行旁边放置一个图标... ///&l...

10得票1回答
XML注释支持哪些字符实体?

在下面的例子中,&和Δ是可以的,但Δ不行(后两个都是Δ)。编译器会发出类似以下警告的警告: warning CS1570: XML comment on 'XXX.DocumentedMethod()' has badly ...

7得票1回答
如何在xml注释的<code>标签中指定语言

有没有一种方法可以在 XML 注释中使用的 &lt;example&gt; 标签中的 &lt;code&gt; 标签中指定所使用的语言? 我正在使用 Sandcastle Help File Builder 从我的 XML 注释中构建文档,但当我在示例部分中包含 VB.net 代码示例时,它...

7得票1回答
当在 cref 中使用 "T:" 时,它代表类型参数。

这里使用cref属性时,T:部分代表什么意思? &lt;see cref="T:System.Windows.Form.Control"/&gt; 并且 &lt;see cref="System.Windows.Form.Control"/&gt;

8得票1回答
如何在XML注释中引用泛型类的扩展方法

什么是适用于IEnumerable接口的SingleOrDefault扩展方法的正确XML注释语法? 我的最新尝试如下: &lt;see cref="IEnumerable{T}.SingleOrDefault{T}()"/&gt; 警告是: XML注释中的'yourMethod'...

23得票6回答
在什么时候,Stylecop的设置停止有用并开始变得烦人?

我在一个团队中工作,我们使用广泛的StyleCop规则集,我想知道这样的工具何时停止有用并开始变得恼人。我们还使用GhostDoc,所以代码中充满了XML注释,这使得代码变得更难读,难以审核。我对XML注释没有问题,在某些地方我发现它们非常有用,但是它们真的需要在每个字段和属性上吗? 我们有...

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

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