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

2019-05-18 14:00

分类代理类工具使用

第15页

term 标题中的项提供一个项。 列表中的每一项用 块指定。创建定义列表时,既需要指定 term description 也需要指定 text。但是,对于表、 term description 项目符号列表或编号列表,只需为 text 提供一个项。 列表或表所拥有的 块数可以根据需要而定。 term 定义的项,该项将在 text 中定义。 description 目符号列表或编号列表中的项或者 term 的定义。 标记使您得以将成员访问记入文档。cref=\member\description 的 cref = \member\对可以通过当前编译环境进行调用的成员或字段的引用。编译器检查到给定代码元素存在后,将 member 转换为输出 XML 中的规范化元素名。必须将 System.Security.PermissionSet 使您得以指定对成员的访问。 member 括在双引号 (\中。 description 成员的访问的说明。 description 标记是可以指定有关类或其他类型的概述信息的位置。

是可以描述该类型的成description 成员的说明。 分类代理类工具使用

第16页

员的位置。 description 标记应当用于方法声明的注释,以描述返回值。 description 返回值的说明。 property-description 标记使您得以描述属性。请注意,当在 Visual Studio .NET 开发环境中通过代码向导添加属性时,它将会为新属性添加

标记。然后,应该手动添加 标记以描述该属性所表示的值。 property-description 属性的说明。

分类代理类工具使用

第17页

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 \ ... } }

不过也有一个例外

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

分类代理类工具使用

第18页

}

应避免不同层次间的变量重名,如 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

分类代理类工具使用

第19页

{ get {

return handle; } }

}


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

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

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

马上注册会员

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