a  +=  c  +  d;
     a  =  (a  +  b)   /   (c  *  d);
     while  (d++  =  s++)
     {
        n++;
     }
     PrintSize(“size is “  +  size  +  “\n”);

for  (expr1;  expr2;  expr3)

    if (condition)
    Array.Remove(1)
    return 1  

    if (condition)
    {
    }
    public int Add(int x, int y)
    {
    }

   if (somevalue == 1)
   {
       somevalue = 2;
   }

    while  (1)
    {
        if  (valid)
        {
         } 
        else
        {
        } // if
    } // while

  namespace Langchao.Procument.Web 
  {
  } // namespace Langchao.Procument.Web

  // <copyright file="文件名.cs" company="HP">
  //  Copyright (c) HP. All rights reserved.
  // </copyright>
  // <author>×××</author>
  // <date> yyyy-mm-dd </date>
  // <summary>文件功能描述</summary>
  // <modify>
  //      修改人：×××
  //      修改时间：yyyy-mm-dd
  //      修改描述：×××
  //      版本：1.0
  // </modify>  

/// <summary>
    /// 类功能的说明
    /// </summary>
    /// <see cref=""></see>
    /// <remarks>
    /// 创建人：Zhangsan
    /// 创建日期：yyyy-mm-dd
    /// 修改人：Lisi
    /// 修改日期：yyyy-mm-dd
    /// 修改备注：无
    /// 版本：1.0
    /// </remarks>
    public class CountersModuleInitializer : ModuleInitializer
    {
}

        /// <summary>
        /// 根据员工编号获得员工信息
        /// </summary>
        /// <param name="employeeId">员工编号</param>
        /// <exception cref="System.Exception">系统异常</exception>
        /// <returns>员工姓名</returns>
        /// <remarks>
        /// 创建人：Zhangsan
        /// 创建日期：yyyy-mm-dd
        /// 修改人：Lisi
        /// 修改日期：yyyy-mm-dd
        /// 修改备注：无
        /// 版本：1.1
        /// </remarks>
        public string GetEmployeeNameById(int employeeId)
        {
            try
            {
                return "ddd";
            }
            catch (System.Exception)
            {
                throw;
            }
}

    /// <summary>
    /// session id
    /// </summary>
    public const string SESSION_ID = "";

    // 注释语句
    private int number;

    if ( 1 == 1)    // always true
    {
        statement; 
    } 
    else     // always false
    {
    }

   //
   //Function:  函数名
   //Purpose:   用途
   //Scope:     作用范围
   //Args:      入口参数(列表)     类型传值方式含义
   //Returns:   返回值类型  (可确定值列表)  含义
   //

   //
   //功能：
   //

//
//Function:  F_FindObject
//Purpose:   按照空间名在可视化主对象中查找住对象内的可视化控件
//Scope:     Public
//Args:      is_name        String   value：要查找的空间名
//           ipbo_object    Object   value: 可视化主对象
//Returns:   Boolean        True     表示找到该控件
//                          False    表示没有找到该控件
//
function F_FindObject(is_name, ipbo_object) {
    //获得显示学生信息的GreeView控件
    var gv_student = document.getElementById("GVStudent");
    ***********
    //返回true
    return true;
}

<list type="bullet" | "number" | "table">
   <listheader>
     <term>term</term>
     <description>description</description>
   </listheader>
   <item>
     <term>term</term>
     <description>description</description>
   </item>
</list>
term 定义的项，该项将在 text 中定义。
description 目符号列表或编号列表中的项或者 term 的定义。

    int level;   //推荐
    int size;    //推荐
    int x, y;    //不推荐 

   void MyMethod()
   {
      int int1 = 0;         // beginning of method block
      if (condition)
      {
          int int2 = 0;     // beginning of "if" block
           ...
      }
   }

    for (int i = 0; i < maxLoops; i++)
    {
         ...
    }

   int count;
    ...
   void MyMethod()
   {
      if (condition)
      {
          int count = 0;     // 避免
           ...
       }
    ...
 } 

   public class Control: Component
   {
       private int handle;
       public  int Handle
       {
          get
          { 
              return handle; 
           }
      }
  }

  System.IO
  System.Web.UI

public class Object {
    public virtual string ToString();
}

public class String {
  public int Length { get; } 
}

public class Process{
  public event EventHandler Exited;
}

public class Convert {
  public static int ToInt32(string userId);
}

public class FileStream
public class Button
public class String

public interface IComponent 
{
    // Implementation code goes here.
}      
public class Component: IComponent 
{
   // Implementation code goes here.
}

public class SampleClass
{
     public Color BackColor 
     {
           // Code for Get and Set accessors goes here.
      }
}

  public enum Color 
  {
     // Insert code for Enum here.
  }
  public class Control
  {
     public Color Color 
     { 
        get
           {
               // Insert code here.
           }
        set
          { 
            // Insert code here.}
    }
  }

   public enum Color
   {
       // Insert code for Enum here. 
   }
   public class Control 
   {
      public int Color 
      { 
          // Insert code here 
      }
   }

  public class MouseEventArgs : EventArgs 
 {
     int x;
     int y;
     public MouseEventArgs(int x, int y) 
     {
         this.x = x;
         this.y = y; 
     }
     public int X
    {
          get
          {
              return x;
           }
      } 
      public int Y
     {
           get
           {
               return y;
            }
     } 
  }

  class SampleClass 
  {
     string url;
     string destinationUrl;
   }

  public struct Color
  {
     public static readonly Color Red = new Color(0x0000FF);
     public Color(int rgb)
    {
       // Insert code here.}
       public Color(byte r, byte g, byte b)
      {
          // Insert code here.
       }
       public byte RedValue 
      { 
         get
         {
             return Color;
          }
       }
  }

  a++;       //推荐
  b--;       //推荐
  a++; b--; //不推荐

  while (d + =  s++)
     {
         n++;
      }

  return;
  return myDisk.size();
  return (size ? size : defaultSize);

           if (condition)
            {
                statements;
            }
            if (condition)
            {
                statements;
            }
            else
            {
                statements;
            }
 
            if (condition)
            {
                statements;
            }
            else if (condition)
            {
                statements;
            }
            else
            {
                statements;
            }   

   for (initialization; condition; update)
   {
          statements;
    }

  for (initialization; condition; update);    // update user id

  foreach (object obj in array)
  {
       statements;
  }

  while (condition)
  {
       statements;
  }

  do
  {
       statements;
  } while (condition);   

              switch (condition)
              {
                     case 1:
                         statements;
                         break;
 
                     case 2:
                         statements;
                         break;
						 
                     default:
                         statements;
                         break;
                 }

              try
              {
                  statements;
              }
              catch (ExceptionClass e)
              {
                  statements;
              }
              finally
              {
                statements;
              }

             using (object)
             {
                 statements;
             }

             goto Label1:
                 statements;
              Lable1:
                  statements;

元素必须被注释
     /// <summary>
    /// Joins a first name and a last name together into a single string.
    /// </summary>
    /// <param name="firstName">The first name to join.</param>
    /// <param name="lastName">The last name to join.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
        return firstName + " " + lastName;
}

 
/// <summary>
    /// Documentation for the first part of Class1.
    /// </summary>
    public partial class Class1
    {
    }
 
    /// <summary>
    /// Documentation for the second part of Class1.
    /// </summary>
    public partial class Class1
    {
 
}

枚举项必须被注释
/// <summary>
    /// Types of animals.
    /// </summary>
    public enum Animals
    {
        /// <summary>
        /// Represents a dog.
        /// </summary>
        Dog,
 
        /// <summary>
        /// Represents a cat.
        /// </summary>
        Cat,
 
        /// <summary>
        /// Represents a horse.
        /// </summary>
        Horse
    }

文档必须包含有效的XML注释
    /// <summary>
    /// An example of badly formed Xml.
    /// </summa3ry>
    public class Example
    {
 
    }

文档注释必须包含Summary
    /// <summary>
    /// Represents a customer in the database.
    /// </summary>
    public class Customer
    {
 
    }

部分文档注释必须包含Summary
/// <summary>
    /// Documentation for the first part of Class1.
    /// </summary>
    public partial class Class1
    {
 
    }
 
    /// <summary>
    /// Documentation for the second part of Class1.
    /// </summary>
    public partial class Class1
    {
 
    }

文档注释Summary必须有内容
/// <summary>  </summary>
/// <param name="customerId">The ID of the customer to find.</param>
/// <returns>The customer, or null if the customer could not be
/// found.</returns>
public Customer FindCustomer(int customerId)
{
    // ... finds the customer ...
}

部分文档注释Summary必须有内容
/// <summary>  </summary>
/// <param name="customerId">The ID of the customer to find.</param>
/// <returns>The customer, or null if the customer could not be found.</returns>
public Customer FindCustomer(int customerId)
{
    // ... finds the customer ...
}
 
修复代码
/// <summary>Attempts to locate a record for the customer with the given ID.
</summary>
/// <param name="customerId">The ID of the customer to find.</param>
/// <returns>The customer, or null if the customer could not be found.</returns>
public Customer FindCustomer(int customerId)
{
    // ... finds the customer ...
}

文档注释不能有默认的Summary
    /// <summary>
    /// Summary description for the Example class.
    /// </summary>
    public class Example
    {
 
    }

属性注释必须有值
  /// <summary>
    /// Gets the name of the customer. 
    /// </summary>
    /// <value>The name of the customer.</value>
    public bool Name
    {
        get { return this.name; }
    }

属性注释必须有值内容
  /// <summary>
    /// Gets the name of the customer. 
    /// </summary>
    /// <value>The name of the customer.</value>
    public bool Name
    {
        get { return this.name; }
    } 

元素的参数必须注释
/// <summary>
    /// Joins a first name and a last name together into a single string.
    /// </summary>
    /// <param name="firstName">The first name to join.</param>
    /// <param name="lastName">The last name to join.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
        return firstName + " " + lastName;
    } 

元素的参数注释必须与元素参数成对
   /// <summary>
    /// Joins a first name and a last name together into a single string.
    /// </summary>
    /// <param name="firstName">The first name to join.</param>
    /// <param name="lastName">The last name to join.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
        return firstName + " " + lastName;
    }

元素的参数注释必须定义参数名
    /// <summary>
    /// Joins a first name and a last name together into a single string.
    /// </summary>
    /// <param name="firstName">The first name to join.</param>
    /// <param name="lastName">The last name to join.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
        return firstName + " " + lastName;
    }

元素的参数注释必须有值
    /// <summary>
    /// Joins a first name and a last name together into a single string.
    /// </summary>
    /// <param name="firstName">The first name to join.</param>
    /// <param name="lastName">The last name to join.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
        return firstName + " " + lastName;
    }

元素的返回值必须被注释
    /// <summary>
    /// Joins a first name and a last name together into a single string.
    /// </summary>
    /// <param name="firstName">The first name to join.</param>
    /// <param name="lastName">The last name to join.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
        return firstName + " " + lastName;
    }

元素的返回值注释必须有值
    /// <summary>
    /// Joins a first name and a last name together into a single string.
    /// </summary>
    /// <param name="firstName">The first name to join.</param>
    /// <param name="lastName">The last name to join.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
        return firstName + " " + lastName;
    }

元素空返回值不能注释
   /// <summary>
    /// Prints the given name.
    /// </summary>
    /// <param name="firstName">The first name.</param>
    /// <param name="lastName">The last name.</param>
    public void PrintNames(string firstName, string lastName)
    {
        Console.WriteLine(firstName + " " + lastName);
    }

泛型参数必须被注释
   /// <summary>
    /// A sample generic class.
    /// </summary>
    /// <typeparam name="S">The first generic type parameter.</typeparam>
    /// <typeparam name="T">The second generic type parameter.</typeparam>
    public class Class1<S, T>
    { 
	
    }

泛型参数在部分类中必须被注释
   /// <summary>
    /// A sample generic class.
    /// </summary>
    /// <typeparam name="S">The first generic type parameter.<
    /// <typeparam name="T">The second generic type parameter.</typeparam>
    public class Class1<S, T>
    { 
    }

泛型参数注释必须与参数类型对应
    /// <summary>
    /// A sample generic class.
    /// </summary>
    /// <typeparam name="S">The first generic type parameter.</typeparam>
    /// <typeparam name="T">The second generic type parameter.</typeparam>
    public class Class1<S, T>
    { 

    }

泛型参数注释必须定义参数名
    /// <summary>
    /// A sample generic class.
    /// </summary>
    /// <typeparam name="S">The first generic type parameter.</typeparam>
    /// <typeparam name="T">The second generic type parameter.</typeparam>
    public class Class1<S, T>
    { 

    } 

泛型参数注释必须有内容
    /// <summary>
    /// A sample generic class.
    /// </summary>
    /// <typeparam name="S">The first generic type parameter.</typeparam>
    /// <typeparam name="T">The second generic type parameter.</typeparam>
    public class Class1<S, T>
    { 

    }

属性摘要文档必须和访问者对应
(参考帮助文档)

属性摘要文档必须必须省略设置访问器约束访问
(参考帮助文档)

元素注释不能被拷贝和粘贴
    /// <summary>
    /// Joins a first name and a last name together into a single string.
    /// </summary>
    /// <param name="firstName">The first name to join.</param>
    /// <param name="lastName">The last name to join.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
        return firstName + " " + lastName;
    }

单行注释不能使用斜线样式
    /// <summary>
    /// Joins a first name and a last name together into a single string.
    /// </summary>
    /// <param name="firstName">Part of the name.</param>
    /// <param name="lastName">Part of the name.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
A legal comment beginning with two slashes:
        // Join the names together.
        string fullName = firstName + " " + lastName;
An illegal comment beginning with three slashes:
        /// Trim the name.
        fullName = fullName.Trim();
A line of commented-out code beginning with four slashes:
        ////fullName = asfd; 
        return fullName;
    }

注释内容不能为空
    /// <summary>
    /// Joins a first name and a last name together into a single string.
    /// </summary>
    /// <param name="firstName"> </param>
    /// <param name="lastName">Part of the name.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
        ...
    }

注释内容首字母必须大写
    /// <summary>
    /// joins a first name and a last name together into a single string.
    /// </summary>
    /// <param name="firstName">The first name.</param>
    /// <param name="lastName">The last name.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
        ...
    }

注释内容必须用句号结尾
    /// <summary>
    /// Joins a first name and a last name together into a single string
    /// </summary>
    /// <param name="firstName">The first name.</param>
    /// <param name="lastName">The last name.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
        ...
    }

注释内容单词之间必须包含空白符
    /// <summary>
    /// Joinsnames
    /// </summary>
    /// <param name="firstName">First</param>
    /// <param name="lastName">Last</param>
    /// <returns>Name</returns>
    public string JoinNames(string firstName, string lastName)
    {
        ...
    }

注释内容必须满足字符比例特殊字符不能过多
    /// <summary>
    /// @)$(*A name--------
    /// </summary>
    public class Name    
    {
        ...
    }

注释内容必须满足小写字符长度
    /// <summary>
    /// A name
    /// </summary>
    public class Name    
    {
        ...
    }

文件必须有文件头部注释
//-----------------------------------------------------------
// <copyright file="NameOfFile.cs" company="CompanyName">
//     Company copyright tag.
// </copyright>
//------------------------------------------------------------
 
For example, a file called Widget.cs from a fictional company called 
Sprocket Enterprises should contain a file header similar to the following:
//------------------------------------------------------------
// <copyright file="Widget.cs" company="Sprocket Enterprises">
//     Copyright (c) Sprocket Enterprises. All rights reserved.
// </copyright>
//-------------------------------------------------------------
The dashed lines at the top and bottom of the header are not strictly 
necessary,so the header could be written as:
// <copyright file="Widget.cs" company="Sprocket Enterprises">
//     Copyright (c) Sprocket Enterprises. All rights reserved.
// </copyright>
It is possible to add additional tags, although they will not be checked
 or enforced by StyleCop:
//-------------------------------------------------------------
// <copyright file="Widget.cs" company="Sprocket Enterprises">
//     Copyright (c) Sprocket Enterprises. All rights reserved.
// </copyright>
// <author>John Doe</author>
//-------------------------------------------------------------

文件头部注释必须显示版权信息标识
//---------------------------------------------------------
// <Tag>A file header which does not contain a copyright tag</Tag>
//--------------------------------------------------------
A file header should include a copyright tag, as follows:
//--------------------------------------------------------
// <copyright file="Widget.cs" company="Sprocket Enterprises">
//     Copyright (c) Sprocket Enterprises. All rights reserved.
// </copyright>
//-------------------------------------------------------

文件头部注释必须有版权信息表示内容
//-----------------------------------------------------------
// <copyright file="Widget.cs" company="Sprocket Enterprises">
// </copyright>
//-----------------------------------------------------------
 
A file header should include copyright text, as follows:
//-----------------------------------------------------------
// <copyright file="Widget.cs" company="Sprocket Enterprises">
//     Copyright (c) Sprocket Enterprises. All rights reserved.
// </copyright>
//----------------------------------------------------------

文件头部注释必须包含文件名
//-----------------------------------------------------
// <copyright file="Widget.cs" company="My Company">
//     Custom company copyright tag.
// </copyright>
//-------------------------------------------------------

文件头部注释必须包含文件名
//-----------------------------------------------------------
// <copyright company="Sprocket Enterprises">
//     Copyright (c) Sprocket Enterprises. All rights reserved.
// </copyright>
//------------------------------------------------------------
 
//------------------------------------------------------------
// <copyright file="Widget.cs" company="Sprocket Enterprises">
//     Copyright (c) Sprocket Enterprises. All rights reserved.
// </copyright>
//---------------------------------------------------------

文件头部注释文件名注释必须与文件名对应
//-----------------------------------------------------------
// <copyright file="File2.cs" company="Sprocket Enterprises">
//     Copyright (c) Sprocket Enterprises. All rights reserved.
// </copyright>
//-----------------------------------------------------------
 
A violation of this rule would occur, since the file tag does not contain 
the name of the file. The header should be written as:
//-----------------------------------------------------------
// <copyright file="File1.cs" company="Sprocket Enterprises">
//     Copyright (c) Sprocket Enterprises. All rights reserved.
// </copyright>
//----------------------------------------------------------

文件头部注释不许有摘要
//----------------------------------------------------------
// <copyright file="Widget.cs" company="Sprocket Enterprises">
//     Copyright (c) Sprocket Enterprises. All rights reserved.
// </copyright>
//----------------------------------------------------------
 
If this rule is enabled, the file header should contain a summary tag.
 For example:
//----------------------------------------------------------
// <copyright file="Widget.cs" company="Sprocket Enterprises">
//     Copyright (c) Sprocket Enterprises. All rights reserved.
// </copyright>
// <summary>Defines the Widget class.</summary>
//----------------------------------------------------------

文件头部注释必须有正确的公司信息
//-----------------------------------------------------------
// <copyright file="Widget.cs" company="Sprocket Enterprises">
//     Copyright (c) Sprocket Enterprises. All rights reserved.
// </copyright>
//--------------------------------------------------------------

文件头部注释公司内容必须对应
//---------------------------------------------------------
// <copyright file="Widget.cs" company="My Company">
//     Custom company copyright tag.
// </copyright>
//----------------------------------------------------------

构造器的Summary注释必须由标准内容开始
(参考帮助文档) 

析构器的Summary注释必须由标准内容开始
    /// <summary>
    /// Initializes a new instance of the <see cref="Customer`1"/> class.
    /// </summary>
    public Customer()
    {
 
    }
 
    /// <summary>
    /// Initializes a new instance of the <see cref="Customer{T}"/> class.
    /// </summary>
    public Customer()
    {
    }

注释头部不能包含空白行
    /// <summary>
    /// <para>
    /// Joins a first name and a last name together into a single string.
    /// </para><para>
    /// Uses a simple form of string concatenation.
    /// </para>
    /// </summary>
    /// <param name="firstName">The first name to join.</param>
    /// <param name="lastName">The last name to join.</param>
    /// <returns>The joined names.</returns>
    public string JoinNames(string firstName, string lastName)
    {
        return firstName + " " + lastName;
    } 

导入的文档注释文件不存在
  ///<include file="IncludedDocumentation.xml" path="root/EnabledMethodDocs"/>
  public bool Enabled(bool true)
  {
 
  }

导入的文档注释的XPath不存在
  ///<include file="IncludedDocumentation.xml" path="root/EnabledMethodDocs"/>
  public bool Enabled(bool true)
  {
 
  } 

导入的结点不存在正确的文件和路径
  ///<include file="IncludedDocumentation.xml" path="root/EnabledMethodDocs"/>
  public bool Enabled(bool true)
  {
 
  }