C#编程规范V1.0(6)

2019-05-18 14:00

分类代理类工具使用

第25页

2 少用缩写。

3 不要在 Enum 类型名称上使用 Enum 后缀。

4 对大多数 Enum 类型使用单数名称,但是对作为位域的 Enum 类型使用复数名称。 5 总是将 FlagsAttribute 添加到位域 Enum 类型。

5.9 参数

以下规则概述参数的命名指南:

1、使用描述性参数名称。参数名称应当具有足够的描述性,以便参数的名称及其类型可

用于在大多数情况下确定它的含义。

2、对参数名称使用 Camel 大小写。

3、 使用描述参数的含义的名称,而不要使用描述参数的类型的名称。开发工具将提供

有关参数的类型的有意义的信息。因此, 通过描述意义,可以更好地使用参数的名称。少用基于类型的参数名称,仅在适合使用它们的地方使用它们。

4、不要使用保留的参数。保留的参数是专用参数,如果需要,可以在未来的版本中公开

它们。相反,如果在类库的未来版本中需要更多的数据,请为方法添加新的重载。

5、不要给参数名称加匈牙利语类型表示法的前缀。

以下是正确命名的参数的示例。 Type GetType(string typeName)

string Format(string format, args() As object)

5.10 方法

以下规则概述方法的命名指南: 1 使用动词或动词短语命名方法。 2 使用 Pascal 大小写。 3 以下是正确命名的方法的实例。 RemoveAll() GetCharArray()

Invoke()

分类代理类工具使用

第26页

5.11 属性 (property)

以下规则概述属性的命名指南: 1 使用名词或名词短语命名属性。 2 使用 Pascal 大小写。 3 不要使用匈牙利语表示法。

4 考虑用与属性的基础类型相同的名称创建属性。例如,如果声明名为 Color 的属性,

则属

性的类型同样应该是 Color。请参阅本主题中后面的示例。

以下代码示例阐释正确的属性命名。 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.

}

分类代理类工具使用

第27页

set {

// Insert code here.

}

} }

以下代码示例不正确,原因是 Color 属性是 Integer 类型的。 public enum Color

{

// Insert code for Enum here.

}

public class Control {

public int Color {

// Insert code here } }

在不正确的示例中,不可能引用 Color 枚举的成员。Color.Xxx 将被解释为访问一个成员,

该成员首先获取 Color 属性( C# 中为 int 类型)的值,然后再访问该值的某个成员(该

员必须是 System.Int32 的实例成员)。

5.12 事件

以下规则概述事件的命名指南:

1、对事件处理程序名称使用 EventHandler 后缀。

2、指定两个名为 sender 和 e 的参数。sender 参数表示引发事件的对象。sender 参

数始

终是object 类型的,即使在可以使用更为特定的类型时也如此。与事件相关联的状态

分类代理类工具使用

第28页

封装

在名为 e 的事件类的实例中。对 e 参数类型使用适当而特定的事件类。 3、用 EventArgs 后缀命名事件参数类。 4、考虑用动词命名事件。

示事

6OnClose。(称为

public delegate void MouseEventHandler(object sender, MouseEventArgs e);

public class MouseEventArgs : EventArgs {

int x;

int y;

public MouseEventArgs(int x, int y) {

public int X { get {

5、使用动名词(动词的“ing”形式)创建表示事件前的概念的事件名称,用过去式表

件后。例如,可以取消的 Close 事件应当具有 Closing 事件和 Closed 事件。不要使

BeforeXxx/AfterXxx 命名模式。

、不要在类型的事件声明上使用前缀或者后缀。例如,使用 Close,而不要使用 7、通常情况下,对于可以在派生类中重写的事件,应在类型上提供一个受保护的方法

OnXxx)。此方法只应具有事件参数 e,因为发送方总是类型的实例。

以下示例阐释具有适当名称和参数的事件处理程序。

以下示例阐释正确命名的事件参数类。

this.x = x; this.y = y; }

分类代理类工具使用

第29页

return x; } }

public int Y {

get

{

return y; } } }

5.13 常量 (const)

以下规则概述常量的命名指南:

常量命名与类名规则一样,不采用如下方式:

( 所有单词大写,多个单词之间用 \隔开。 如

public const string PAGE_TITLE = \)

5.14 字段

以下规则概述字段的命名指南:

1、private、protected 使用 Camel 大小写。 2、public 使用 Pascal 大小写。

3、拼写出字段名称中使用的所有单词。仅在开发人员一般都能理解时使用缩写。字段

名称不

要使用大写字母。下面是正确命名的字段的示例。

class SampleClass {

string murl;

string mdestinationUrl;

}


C#编程规范V1.0(6).doc 将本文的Word文档下载到电脑 下载失败或者文档不完整,请联系客服人员解决!

下一篇:北航自动控制原理实验六报告

相关阅读
本类排行
× 注册会员免费下载(下载后可以自由复制和排版)

马上注册会员

注:下载文档有可能“只有目录或者内容不全”等情况,请下载之前注意辨别,如果您已付费且无法下载或内容有问题,请联系我们协助你处理。
微信: QQ: