标签：des style blog http io ar os 使用 sp
类型、属性、事件、方法、方法参数，根据需要添加注释。
如果类型、属性、事件、方法、方法参数的名称已经是自解释了，不需要加注释；否则需要添加注释。
当添加注释时，添加方式如下图所示：
优先考虑英文，如果英文没有合适的单词描述，可以使用拼音，使用中文是不符合要求的。
唯一可以使用中文的地方是枚举的枚举项，枚举项实际已经不属于本节标题的范畴了。这里只是放到一起说明，如下图所示：
所有类型、方法、参数、变量的命名不得使用缩写，包括大家熟知的缩写，例如msg。
第一步，打开Visual Studio，进入“工具”，“选项...”，如下图所示：
第二步，进入“文本编辑器”，“C#”，“格式设置”，“新行”，取消掉右侧所有复选框中的对号，如下图所示：
第三步，点击“确定”，完成设置。
第一步，打开Visual Studio，进入“工具”，“选项...”，如下图所示：
第二步，进入“文本编辑器”，“C#”，“制表符”，如下图所示，设置制表符。
第三步，点击“确定”，完成设置。
如果两个类型的关系是紧密相关的，比如 产品、产品类型，此时Product类，和ProductType枚举可以定义在同一个Product.cs文件中。
但不能在一个.cs文件中出现两个不相关的类型定义，例如将 Product类和Reseller类（分销商）定义在一个BasicInfo.cs文件中。
当类型命名为Product时，其源文件命名只能是Product.cs。
如下图所示，红色标记的为使用Pascal风格的类型：
注意ProductType是私有类型，不管类型是公有的还是私有的，其命名总是采用Pascal风格。
红色标记的为使用Camel风格的变量或者方法参数：
示例代码如下：
范例1.9 中的if判断实际上与下面的语句是等效的：
示例代码如下：
代码示例如下：
如果需要公有字段，使用属性进行包装。
类型成员的排列顺序自上而下依次为：
字段：私有字段、受保护字段
属性：私有属性、受保护属性、公有属性
事件：私有事件、受保护事件、公有事件
构造函数：参数数量最多的构造函数，参数数量中等的构造函数，参数数量最少的构造函数
方法：重载方法的排列顺序与构造函数相同，从参数数量最多往下至参数最少。
委托以EventHandler作为后缀命名，例如 SalesOutEventHandler。
事件以其对应的委托类型，去掉EventHandler后缀，并加上On前缀构成。
例如，对于SalesOutEventHandler委托类型的事件，其事件名称为：OnSalesOut。
示例代码如下：
如果方法返回的类型为bool类型，则其前缀为Is、Can或者 Try，例如：
凡符合下表所列的集合类型，应添加相应的后缀。
| 说明 | 后缀 | 示例 |
| 数组 | Array | int[] productArray |
| 列表 | List | List<Product> productList |
| DataTable/HashTable | Table | HashTable productTable |
| 字典 | Dictionary | Dictionay<string,string> productDictionary |
| EF中的DbSet /DataSet | Set | DbSet<Product> productSet |
凡符合下表所列的局部变量、方法参数、字段、属性，均需添加相应的后缀。
| 说明 | 后缀 | 示例 | 示例说明 |
| 费用相关 | Cost | ShipCost | 运输费 |
| 价格相关 | Price | ProductUnitPrice | 产品单价 |
| 消息相关 | Message（弃用Note） | SuccessMessage | 成功消息 |
| 日期相关 | Date（弃用Time） | OrderDate | 下单日期 |
| 计数、数量相关 | Count（弃用Time） | LoginCount | 登录次数 |
| 链接地址相关 | Url | BlogUrl | 博客链接 |
| 图片相关 | Image | SignImage | 签名图片 |
| 金额相关 | Amount | PrepaidAmount | 预付款 |
| 点数、积分相关 | Point | MemberPoint | 会员积分 |
| 记录、日志相关 | Record（弃用Log） | ErrorRecord | 错误记录 |
| 配置相关 | Config | DataBaseConfig | 数据库配置 |
| 状态相关 | Status | OrderStatus | 订单状态 |
| 模式、方式相关 | Mode | OpenMode | 打开方式 |
| 种类相关 | Category / Type 二选一 | UserCategory | 用户种类 |
| 工厂类相关 | Factory | ConnectionFactory | 连接工厂 |
| 启用相关 | Enabled | ExportEnabled | 开启导出 |
| 流相关 | Stream | UploadStream | 上传流 |
| 读取器相关 | Reader | ExcelReader | Excel读取器 |
| 写入器相关 | Writer | ExcelWriter | Excel写入器 |
| 适配器相关 | Adapter | IntroOPAdapter | IntroOP适配器 |
| 提供器相关 | Provider | MemebershipProvider | 会员信息提供器 |
| 包装器相关 | Wrapper | ProductWrapper | Product包装器 |
| 连接相关 | Connection | ExcelConnection | Excel连接 |
凡存在下表中的类型，需采用下表指定的名称命名。
| 类型 | 命名 | 类型 | 命名 |
| 客户 | Customer | 分销商 | Reseller |
| 零售商 | Retailer | 经销商/批发商 | Dealer |
| 用户 | UserInfo（User为数据库关键字） | 订单 | OrderInfo（Order为数据库关键字） |
| 供应商 | Supplier | 管理员 | Admin |
| 密码 | Password | 会员 | Member |
| 评论 | Remark（弃用Comment） | 文章 | Article |
| 新闻 | News | 发票 | Invoice |
| 导入 | Import | 导出 | Export |
| 公司、企业 | Company（弃用Enterprise） | 产品 | Product |
| 省份 | Province | 城市 | City |
| 区县 | District | 地址 | Address |
| 角色 | Role（弃用Group） | 权限 | Authority（弃用Permission） |
| 仓库 | Warehouse | 工厂 | Plant |
| 登录 | Login（弃用SignIn） | 登出 | LogOut（弃用SignOut） |
| 创建 | Create（弃用Add） | 编辑 | Edit |
| 更新 | Update | 删除 | Remove（弃用Delete） |
| 照片 | Photo | 图片 | Image |
字段、属性种类比较繁杂，因此仅列出最常用的几项。
| 类型 | 名称 | 类型 | 名称 |
| Id（int型） | Id（“d”小写，弃用ID） | GuidId（Guid型） | Id |
| Name | 名称 | Title | 标题 |
| Remark | 备注、描述（弃用Memo、Description） | Category | 种类（弃用Class、Type） |
| Linkman | 联系人 |
下面是书写符合要求的例子：
下面是书写 不符合要求 的例子：
示例代码如下：
标注方式如下：
设置方法参考1.4节。
设置方法参考1.5节。
注释主要说明该样式应用于页面的哪个部分，而非说明样式的应用效果，代码注释风格如下所示：
每一个样式设置必须独占一行，不能位于同一行，下面是符合要求的写法：
下面是 不符合要求 的写法：
嵌入式样式为直接写在HTML标记内部的样式，如下图所示：
内联式样式为写在<head></head>中的样式，如下图所示：
内联式样式，不能 写在<body></body>之间。
外联式样式表为写在.css文件中的样式，通过link引入到XHTML页面中，如下图所示：
设置方法参考1.4节。
设置方法参考1.5节。
代码注释需要说明“函数功能”、“入口参数”、“返回值”，注释范例如下：
其中第一行说明函数功能；第二行说明入口参数；最后一行说明返回值
内嵌式代码是指写在XHTML标记中的JavaScript代码，下面的写法是 不符合要求 的：
内联式代码是指写在<head />或者<body />之间的代码：
外联式代码指写在单独的.js文件中，然后通过script标记连接到XHTML页面中的代码。
感谢阅读，希望这篇文章能给你带来帮助！
标签：des style blog http io ar os 使用 sp
原文地址：http://www.cnblogs.com/yanbo1/p/4132956.html
