公司C编程格式规范v1.0.0(修正版)

海予公司C#编程格式规范

版本：1.0.0

浙江海予信息技术有限公司

2011年1月18日

更新记录

目录

1、 概述 ..................................................................................................................... 6 1.1 规范制定原则.................................................................................................. 6 1.2 术语定义.......................................................................................................... 6 1.3 文件命名组织.................................................................................................. 6 1.3.1 文件命名................................................................................................... 6 1.3.2 文件注释................................................................................................... 6 2、 代码外观 ............................................................................................................. 8 2.1 列宽.................................................................................................................. 8 2.2 换行.................................................................................................................. 8 2.3 缩进.................................................................................................................. 8 2.4 空行.................................................................................................................. 8 2.5 空格.................................................................................................................. 9 2.6 括号 - () ........................................................................................................ 9 2.7 花括号 - {}................................................................................................... 10 3、 程序注释 ........................................................................................................... 11 3.1 注释概述........................................................................................................ 11 3.2 文档型注释.................................................................................................... 12 3.3 类C注释 ........................................................................................................ 12 3.4 单行注释........................................................................................................ 13 3.5 注释标签........................................................................................................ 13 4、 申明 ................................................................................................................... 16 4.1 每行声明数.................................................................................................... 16 4.2 初始化............................................................................................................ 16 4.3 位置................................................................................................................ 16 4.4 类和接口的声明............................................................................................ 17 4.5 字段的声明.................................................................................................... 17 5、 命名规范 ........................................................................................................... 19 5.1 命名概述........................................................................................................ 19

5.3 缩写................................................................................................................ 20 5.4 命名空间........................................................................................................ 21 5.5 类.................................................................................................................... 21 5.6 接口................................................................................................................ 22 5.7 属性 (ATTRIBUTE) ......................................................................................... 23 5.8 枚举 (ENUM) ................................................................................................. 23 5.9 参数................................................................................................................ 23 5.10 5.11 5.12 5.13 5.14 5.15 5.16 5.17

方法 ............................................................................................................ 24 属性 (PROPERTY) .......................................................................................... 24 事件 ............................................................................................................ 26 常量 (CONST) .............................................................................................. 28 字段 ............................................................................................................ 28 静态字段 .................................................................................................... 29 集合 ............................................................................................................ 29 措词 ............................................................................................................ 29

6、 语句 ................................................................................................................... 31 6.1 每行一个语句................................................................................................ 31 6.2 复合语句........................................................................................................ 31 6.3 6.4 6.5 6.6 6.7 6.8 6.9 6.10 6.11

RETURN 语句 ................................................................................................. 31 IF、 IF-ELSE、IF ELSE-IF 语句 ...................................................................... 31 FOR、FOREACH 语句 ..................................................................................... 32 WHILE 语句 .................................................................................................... 33 DO - WHILE 语句 ............................................................................................ 33 SWITCH - CASE 语句 ......................................................................................... 33 TRY - CATCH 语句 ............................................................................................ 34 USING 块语句 .................................................................................................. 35 GOTO 语句 ........................................................................................................ 35

7、 控件命名规则 ................................................................................................... 36

7.2 主要控件名简写对照表................................................................................ 36 8、 其他 ................................................................................................................... 37 8.1 表达式............................................................................................................ 37 8.2 类型转换........................................................................................................ 37 附录一: 匈牙利命名法.............................................................................................. 38

1、 概述

1.1

规范制定原则

1 方便代码的交流和维护；

2 不影响编码的效率，不与大众习惯冲突； 3 使代码更美观、阅读更方便； 4 使代码的逻辑更清晰、更易于理解。

1.2 术语定义

Pascal 大小写：将标识符的首字母和后面连接的每个单词的首字母都大写。可以对三字符或更多字符的标识符使用Pascal 大小写。例如： BackColor

Camel 大小写：标识符的首字母小写，而每个后面连接的单词的首字母都大写。例如： backColor

1.3 文件命名组织

1.3.1 文件命名

1、 文件名遵从Pascal命名法，无特殊情况，扩展名小写。 2、 使用统一而又通用的文件扩展名： C# 类 .cs。

1.3.2 文件注释

1、 在每个文件头必须包含以下注释说明：

/*----------------------------------------------------------------

// Copyright (C) 2004集团有限公司 // 版权所有。 //

// 文件名：

// 文件功能描述： // //

// 创建标识： //

// 修改标识： // 修改描述： //

// 修改标识： // 修改描述：

//--------------------------------------------------------------*/

“文件功能描述”只需简述，具体详情在类的注释中描述。

“创建标识”和“修改标识”由创建或修改人员的拼音或英文名加日期组成。如：

李轶

20040408

一天内有多个修改的只需做一个在注释说明中做一个修改标识就够了。 在所有的代码修改处加上修改标识的注释。

2、 代码外观

2.1 列宽

代码列宽控制在110字符左右。

2.2 换行

当表达式超出或即将超出规定的列宽，遵循以下规则进行换行 1、在逗号后换行； 2、 在操作符前换行； 3、规则1优先于规则2。

当以上规则会导致代码混乱的时候自己采取更灵活的换行规则。

2.3 缩进

缩进应该是每行一个Tab(4个空格)，不要在代码中使用Tab字符。

Visual 设置：工具->选项->文本编辑器->C#->制表符->插入空格

2.4 空行

空行是为了将逻辑上相关联的代码分块，以便提高代码的可阅读性。 a、在以下情况下使用两个空行： 1、接口和类的定义之间； 2、枚举和类的定义之间； 3、类与类的定义之间。

b、在以下情况下使用一个空行： 1、方法与方法、属性与属性之间； 2、方法中变量声明与语句之间； 3、方法与方法之间；

4、方法中不同的逻辑块之间；

5、方法中的返回语句与其他的语句之间； 6、属性与方法、属性与字段、方法与字段之间；

7、注释与它注释的语句间不空行，但与其他的语句间空一行。

2.5 空格

在以下情况中要使用到空格

1、 关键字和左括符 “(” 应该用空格隔开。如：

while (true)

注意：在方法名和左括符 “(” 之间不要使用空格，这样有助于辨认代码中的方法调用与关键字。

2、多个参数用逗号隔开，每个逗号后都应加一个空格。

3、除了 . 之外，所有的二元操作符都应用空格与它们的操作数隔开。一元操作符、++及--与操作数间不需要空格。如

a += c + d;

a = (a + b) / (c * d); while (d++ = s++) { n++; }

PrintSize(“size is “ + size + “\n”);

4、 语句中的表达式之间用空格隔开。如

for (expr1; expr2; expr3)

2.6 括号 - ()

1、 左括号“(” 不要紧靠关键字，中间用一个空格隔开。 2、 左括号“(” 与方法名之间不要添加任何空格。 3、 没有必要的话不要在返回语句中使用()。如

if (condition)

Array.Remove(1) return 1

2.7 花括号 - {}

1、 左花括号 “{” 放于关键字或方法名的下一行并与之对齐。如

if (condition)

{ }

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

2、 左花括号 “{” 要与相应的右花括号 “}”对齐。

3、 通常情况下左花括号 “{”单独成行，不与任何语句并列一行。 4、 if、while、do语句后一定要使用{}，即使{}号中为空或只有一条语句。如

if (somevalue == 1)

{

somevalue = 2; }

5、 右花括号 “}” 后建议加一个注释以便于方便的找到与之相应的 {。如:

while (1)

{

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

} // not valid } // end forever

3、 程序注释

3.1 注释概述

1、修改代码时，总是使代码周围的注释保持最新。

2、在每个例程的开始，提供标准的注释样本以指示例程的用途、假设和限制很有帮助。注释样本应该是解释它为什么存在和可以做什么的简短介绍.

3、避免在代码行的末尾添加注释；行尾注释使代码更难阅读。不过在批注变量声明时，行尾注释是合适的；在这种情况下，将所有行尾注释在公共制表位处对齐。

4 、避免杂乱的注释，如一整行星号。而是应该使用空白将注释同代码分开。 5 、避免在块注释的周围加上印刷框。这样看起来可能很漂亮，但是难于维护。

6 、在部署发布之前，移除所有临时或无关的注释，以避免在日后的维护工作中产生混乱。

7 、如果需要用注释来解释复杂的代码节，请检查此代码以确定是否应该重写它。尽一切可能不注释难以理解的代码，而应该重写它。尽管一般不应该为了使代码更简单以便于人们使用而牺牲性能，但必须保持性能和可维护性之间的平衡。

8 、在编写注释时使用完整的句子。注释应该阐明代码，而不应该增加多义性。

9 、在编写代码时就注释，因为以后很可能没有时间这样做。另外，如果有机会复查已编写的代码，在今天看来很明显的东西六周以后或许就不明显了。

10 、避免多余的或不适当的注释，如幽默的不主要的备注。 11、 使用注释来解释代码的意图。它们不应作为代码的联机翻译。 12、 注释代码中不十分明显的任何内容。

13 、为了防止问题反复出现，对错误修复和解决方法代码总是使用注释，尤其是在团队环境中。

14 、对由循环和逻辑分支组成的代码使用注释。这些是帮助源代码读者的主要方面。

15 、在整个应用程序中，使用具有一致的标点和结构的统一样式来构造注释。

16 、用空白将注释同注释分隔符分开。在没有颜色提示的情况下查看注释时，这样做会使注释很明显且容易被找到。

17 、在所有的代码修改处加上修改标识的注释。

18 、为了是层次清晰，在闭合的右花括号后注释该闭合所对应的起点。

namespace Langchao.Procument.Web {

} // namespace Langchao.Procument.Web

3.2 文档型注释

该类注释采用.Net已定义好的Xml标签来标记，在声明接口、类、方法、属性、字段都应该使用该类注释，以便代码完成后直接生成代码文档，让别人更好的了解代码的实现和接口。如：

///<summary>MyMethod is a method in the MyClass class.

///<para>Here's how you could make a second paragraph in a description. ///<see cref="System.Console.WriteLine"/> ///for information about output statements. ///</para>

///<seealso cref="MyClass.Main"/> ///</summary>

public static void MyMethod(int Int1) { }

3.3 类c注释

该类注释用于：

1、 不再使用的代码。 2、 临时测试屏蔽某些代码。 用法：

/*

[修改标识] [修改原因]

. . . (the source code ) */

3.4 单行注释

该类注释用于

1、 方法内的代码注释。如变量的声明、代码或代码段的解释。注释示例：

//

// 注释语句

//

private int number;

或

// 注释语句

private int number;

2、 方法内变量的声明或花括号后的注释, 注释示例：

if ( 1 == 1) // always true

{

statement; } // always true

3.5 注释标签

要引用的参数名。将此名称用双引号括起来 (" ")。 <see> <see cref="member"/> cref = "member" 对可以通过当前编译环境进行 调用的成员或字段的引用。编译器检查到给定 代码元素存在后，将 member 传递给输出 XML 中的元素名。必须将 member 括在双引 号 (" ") 中。 <seealso> <seealso cref="member"/> cref = "member" 对可以通过当前编译环境进行 调用的成员或字段的引用。编译器检查到给定 代码元素存在后，将 member 传递给输出 XML 中的元素名。必须将 member 括在双引 号 (" ") 中 <example> <example>description</example> description 代码示例的说明。 <code> <code>content</code> content 为希望将其标记为代码的文本。 <summary> <summary>description</summary> 此处 description 为对象的摘要。 <exception> <exception cref="member">description</exception> cref = "member" 对可从当前编译环境中获取的 异常的引用。编译器检查到给定异常存在后，将 member 转换为输出 XML 中的规范化元素 名。必须将 member 括在双引号 (" ") 中。 description 说明。 <include file='filename' path='tagpath[@name="id"]' /> filename 包含文档的文件名。该文件名可用路 径加以限定。将 filename 括在单引号中 (' ')。 Tagpath:filename

中指向标记名的标记路 径。将此路径括在单引号中 (' ')。 name 注释前边的标记中的名称说明符；名称 具有一个 id。 id 位于注释之前的标记的 id。 将此 id 括在双引号

格式化该参数。 使您得以从文本内指定链接。使用 <seealso> 指示希望在“请参阅”一 节中出现的文本。

使您得以指定希望在“请参阅”一节 中出现的文本。 使用 <see> 从文本

使用 <example> 标记可以指定使 用方法或其他库成员的示例。一般 情况下，这将涉及到 <code> 标记 的使用。 记为您提供了一种将多行指示为代 码的方法。 使用 <c> 指示应将说明 中的文本标记为代码 应当用于描述类型成员。使用 <remarks> 以提供有关类型本身的 信息。 <exception> 标记使您可以指定类 能够引发的异常。

<include>

<include> 标记使您得以引用描述 源代码中类型和成员的另一文件中 的注释。这是除了将文档注释直接 置于源代码文件中之外的另一种可 选方法。 <include> 标记使用 XML XPath 语法。有关自定义 <include> 使用 的方法，请参阅 XPath 文档。

中 (" ")。 <list> <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 的定义。 <permission> <permission cref="member">description</permission> cref = "member" 对可以通过当前编译环境进行 调用的成员或字段的引用。 编译器检查到给定代 码元素存在后，将 member 转换为输出 XML 中的规范化元素名。必须将 member 括在双引 号 (" ") 中。 description 成员的访问的说明。 <remarks> <remarks>description</remarks> description 成员的说明。 <returns> <returns>description</returns> description 返回值的说明。 <value> <value>property-description</value> property-description 属性的说明。 <value> 标记使您得以描述属性。 请注意，当在 Visual Studio .NET 开发环境中通过代码向导添加属性 时，它将会为新属性添加 <summary> 标记。然后，应该手 动添加 <value> 标记以描述该属 性所表示的值。 <remarks> 标记是可以指定有关类 或其他类型的概述信息的位置。 <summary> 是可以描述该类型的 成员的位置。 <returns> 标记应当用于方法声明 的注释，以描述返回值。 <permission> 标记使您得以将成 员的访问记入文档。 System.Security.PermissionSet 使您得以指定对成员的访问。 <listheader> 块用于定义表或定义 列表中的标题行。定义表时，只需 为标题中的项提供一个项。 列表中的每一项用 <item> 块指 定。创建定义列表时，既需要指定 term 也需要指定 text。但是，对于 表、项目

符号列表或编号列表，只 需为 text 提供一个项。 列表或表所拥有的 <item> 块数可 以根据需要而定。

4、 申明

4.1 每行声明数

一行只建议作一个声明，并按字母顺序排列。如:

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

4.2 初始化

建议在变量声明时就对其做初始化。

4.3 位置

变量建议置于块的开始处，不要总是在第一次使用它们的地方做声明。如:

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; // 避免 ... } ...

}

4.4 类和接口的声明

1 在方法名与其后的左括号间没有任何空格；

2 左花括号 “{” 出现在声明的下行并与之对齐，单独成行； 3 方法间用一个空行隔开。

4.5 字段的声明

不要使用是 public 或 protected 的实例字段。如果避免将字段直接公开给开发人员，可以更轻松地对类进行版本控制，原因是在维护二进制兼容性时字段不能被更改为属性。考虑为字段提供 get 和set 属性访问器，而不是使它们成为公共的。 get 和 set 属性访问器中可执行代码的存在使得可以进行后续改进，如在使用属性或者得到属性更改通知时根据需要创建对象。下面的代码示例阐释带有get 和 set 属性访问器的私有实例字段的正确使用。 示例：

public class Control: Component {

private int handle; public int Handle {

get {

return handle;

} } }

5、 命名规范

5.1 命名概述

名称应该说明“什么”而不是“如何”。通过避免使用公开基础实现（它们会发生改变）的名称，可以保留简化复杂性的抽象层。例如，可以使用 GetNextStudent()，而不是 GetNextArrayElement()。

命名原则是：

选择正确名称时的困难可能表明需要进一步分析或定义项的目的。使名称足够长以便有一定的意义，并且足够短以避免冗长。唯一名称在编程上仅用于将各项区分开。表现力强的名称是为了帮助人们阅读；因此，提供人们可以理解的名称是有意义的。不过，请确保选择的名称符合适用语言的规则和标准。

以下几点是推荐的命名方法。

1、避免容易被主观解释的难懂的名称，如方面名 AnalyzeThis()，或者属性名 xxK8。这样的名称会导致多义性。

2、在类属性的名称中包含类名是多余的，如 Book.BookTitle。而是应该使用 Book.Title。

3、只要合适，在变量名的末尾或开头加计算限定符（Avg、Sum、Min、Max、Index）。

4、在变量名中使用互补对，如 min/max、begin/end 和 open/close。 5、布尔变量名应该包含 Is，这意味着 Yes/No 或 True/False 值，如 fileIsFound。

6、在命名状态变量时，避免使用诸如 Flag 的术语。状态变量不同于布尔变量的地方是它可以具有两个以上的可能值。不是使用 documentFlag，而是使用更具描述性的名称，如 documentFormatType。 （此项只供参考）

7、即使对于可能仅出现在几个代码行中的生存期很短的变量，仍然使用有意义的名称。仅对于短循环索引使用单字母变量名，如 i 或 j。 可能的情况下，尽量不要使用原义数字或原义字符串，如For i = 1 To 7。而是使用命名常数，如 For i = 1 To NUM_DAYS_IN_WEEK 以便于维护和理解。

5.2 大小写规则

大写：标识符中的所有字母都大写。仅对于由两个或者更少字母组成的标识符使用该约定。例如：

System.IO System.Web.UI

下表汇总了大写规则，并提供了不同类型的标识符的示例。

5.3 缩写

为了避免混淆和保证跨语言交互操作，请遵循有关区缩写的使用的下列规则：

1、 不要将缩写或缩略形式用作标识符名称的组成部分。例如，使用

GetWindow，而不要使用 GetWin。

2、 不要使用计算机领域中未被普遍接受的缩写。

3、 在适当的时候，使用众所周知的缩写替换冗长的词组名称。例如，用 UI 作为 User Interface 缩

写，用 OLAP 作为 On-line Analytical Processing 的缩写。

4、 在使用缩写时，对于超过两个字符长度的缩写请使用 Pascal 大小写或 Camel 大小写。例如，使用 HtmlButton 或 HTMLButton。但是，应当大写仅有两个字符的缩写，如，System.IO，而不是 System.Io。

5、不要在标识符或参数名称中使用缩写。如果必须使用缩写，对于由多于两个字符所组成的缩写请

使用Camel 大小写，虽然这和单词的标准缩写相冲突。

5.4 命名空间

1、命名命名空间时的一般性规则是使用公司名称，后跟技术名称和可选的功能与设计，如下所示。

CompanyName.TechnologyName[.Feature][.Design]

例如：

namespace Langchao.Procurement //浪潮公司的采购单管理系统

namespace Langchao.Procurement.DataRules //浪潮公司的采购单管理系统的业务规则模块

2、命名空间使用Pascal大小写，用逗号分隔开。

3、TechnologyName 指的是该项目的英文缩写，或软件名。

4、命名空间和类不能使用同样的名字。例如，有一个类被命名为Debug后，就不要再使用Debug作为一个名称空间名。

5.5 类

1、使用 Pascal 大小写。 2、用名词或名词短语命名类。

3、使用全称避免缩写，除非缩写已是一种公认的约定，如URL、HTML 4 、不要使用类型前缀，如在类名称上对类使用 C 前缀。例如，使用类名称 FileStream，而不是 CFileStream。

5 、不要使用下划线字符 (_)。

本文来源：https://www.bwwdw.com/article/gvi1.html