接口和类方法的注释应该有什么区别？
我在使用C#和Web Client Software Factory(WCSF)开发ASP.net web应用程序时遇到了这个问题，其他平台和语言也可能会遇到同样的问题。我的情况是这样的： 我基于WCSF范例为每个网页/用户控件定义一个IView接口，然后让页面类实现IView接口，基本上实...
如何记录XML文件的结构
在记录XML文件的结构时... 我的一位同事使用Word表格。 另一个将元素粘贴到带有此类注释的Word文档中：<learningobject id="{Learning Object Id (same value as the loid tag)}" xm...
代码契约 + 沙堡 -- 有没有办法自定义异常部分？
我正在使用的Code Contracts版本是：1.4.40602.0 我复制了必要的Content和Transforms文件 Sandcastle根据我的合同要求输出异常信息 示例代码: public class MyClass { public MyClass(Object...
Visual Studio单行XML摘要注释
在Visual Studio中，我如何将默认的XML摘要注释片段从三行改为一行？当前，当我输入 /// 时，它会提供以下代码片段：/// <summary> /// /// </summary> 我想要这个更简短的片段：///<summary></s...
如何在使用XSD.exe生成的C#类中包含xsd:documentation?
我正在使用xsd.exe从一组xsd文件中生成一个C#类。 Xsd文件使用<xsd:documentation>标签包括有用的描述信息。例如：<xsd:complexType name="AddressType"> <xsd:annotation> ...
C#，XmlDoc：如何引用方法重载
如果我有以下两个方法：public Foo Get(string bar) { ... } public Foo Get(int bar) { ... } 并将这段XML文档注释写在另一个方法上/// <summary> /// Has a close relation to th...
当我编写XML文档时，如何在方法概述中引用方法参数？
假设我有一个如下的方法： /// <summary> /// Here I want to reference the parameter <see cref="personId"/>. /// </summary>...
Delphi中的XML注释中的<see>标签在哪些情况下实际起作用？
我想知道这些 XML 引用是如何工作的，我不明白为什么它们起作用或者不起作用，而且我也没有找到关于这方面的任何信息。 以下是一个例子：type TOuterClass= class strict private type TLogger = class ...
如何在Web Api的Xml文档中包含来自主项目以外的文档？
似乎只有处理您的Web Api项目中所有API类型都是一部分的情况下，才能启用XmlDoc集成的文档。特别是它讨论了如何将XML文档重定向到App_Data/XmlDocument.xml并取消注释配置中将使用该文件的行。这仅隐含地允许一个项目的文档文件。 然而，在我的设置中，我在一个公共“...
C#/.NET中的方法自动记录异常
我想要一些工具，最好是可以插入到VS 2008/2010中的，能够遍历我的方法并添加关于可能引发的异常的XML注释。 我不希望为我生成<summary>或其他XML标记，因为我将自己填写这些内容，但如果即使在私有/受保护的方法中，我也可以看到可能会被抛出的异常列表，那就太好了。否则...