代码规范

代码规范
1 代码文件头注释 FileComment.snippet

<?xml version="1.0" encoding="utf-8" ?>
<CodeSnippets xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
  <CodeSnippet Format="1.0.0">
    <Header>
      <Title>FileComment</Title>
      <Description>Code snippet for generate file comment</Description>
      <Author>qiangguo</Author>
      <Shortcut>fc</Shortcut>
    </Header>
    <Snippet>
      <Declarations>
        <Literal>
          <ID>classname</ID>
          <ToolTip>name of class</ToolTip>
          <Default>MyClass</Default>
        </Literal>
        <Literal>
          <ID>author</ID>
          <ToolTip>author</ToolTip>
          <Default>qiangguo</Default>
        </Literal>
        <Literal>
          <ID>version</ID>
          <ToolTip>version</ToolTip>
          <Default>1.0</Default>
        </Literal>
        <Literal>
          <ID>time</ID>
          <ToolTip>time of create file</ToolTip>
          <Default>2010-06-01</Default>
        </Literal>
      </Declarations>
      <Code Language="CSharp">
        <![CDATA[
#region File Comment
// +-------------------------------------------------------------------------+
// + Copyright (C), xxx Co., Ltd.
// +-------------------------------------------------------------------------+
// + FileName:$classname$.aspx.cs
// +-------------------------------------------------------------------------+
// + Author:$author$   Version:$version$   Date:$time$
// +-------------------------------------------------------------------------+
// + Description:
// +             $classname$定义
// +-------------------------------------------------------------------------+
// + History:
// +         <author>     <time>     <desc>
// +-------------------------------------------------------------------------+
#endregion
                ]]>
      </Code>
    </Snippet>
  </CodeSnippet>
</CodeSnippets> 

2 用Microsoft.StyleCop检查
去除以下规则
SA1630:A section of the Xml header documentation for a C# element does not contain any whitespace between words.
SA1632:A section of the Xml header documentation for a C# element is too short.
SA1200:A C# using directive is placed outside of a namespace element.

SA1633:A C# code file is missing a standard file header.

posted @ 2010-06-01 16:34  深潭  阅读(495)  评论(0编辑  收藏  举报