Repository files navigation

/******************************************************************* * Description:This is a example class * Version: 1.0.0 * Date: 20180218 * Author: Hiram * Email: hiramtan@live.com * Copyright @ www.wikipedia.org *******************************************************************/usingSystem;/// <summary>/// 命名空间(Pascal)/// </summary>namespaceNamespace{/// <summary>/// 类(Pascal)/// </summary>publicclassClass{/// <summary>/// 属性(Pascal)/// </summary>publicintProperty{get;set;}/// <summary>/// 委托(Pascal):EventHandler后缀/// </summary>publicdelegatevoidEvnetHandler();/// <summary>/// 事件(Pascal):On前缀/// </summary>publiceventEvnetHandlerOnEvent;/// <summary>/// 公有字段(Pascal)/// </summary>publicreadonlyintField1;/// <summary>/// 受保护字段(Pascal)/// </summary>protectedintField2;/// <summary>/// 私有字段(_Camel)/// </summary>privateint_field3;/// <summary>/// 方法(Pascal)/// </summary>/// <param name="args">参数(Camel)</param>publicvoidMethod(intargs){//局部变量(Camel)intvariable=10;}}/// <summary>/// 接口(Pascal)/// </summary>publicinterfaceIInterface{/// <summary>/// 属性接口(Pascal)/// </summary>intProperty{get;set;}/// <summary>/// 方法接口(Pascal)/// </summary>/// <param name="args"></param>voidMethod(intargs);}/// <summary>/// 枚举(Pascal)/// </summary>enumEnum{Enum1,//枚举值(Pascal)Enum2,//枚举值(Pascal)}}

• 微软官方老版本:https://msdn.microsoft.com/en-us/library/ms229043(v=vs.100).aspx
• 微软官方新版本:https://docs.microsoft.com/en-us/dotnet/standard/design-guidelines/capitalization-conventions
• ReSharper:https://www.jetbrains.com/help/resharper/Coding_Assistance__Naming_Style.html
• dofactory:http://www.dofactory.com/reference/csharp-coding-standards
• https://github.com/ktaranov/naming-convention/blob/master/C%23%20Coding%20Standards%20and%20Naming%20Conventions.md
• https://gist.github.com/jburditt/3178227739d3a604663e58fc2e6c15c5
• https://www.jianshu.com/p/0d09cc624dae
• https://github.com/wanfangdata/guide/blob/master/dotnet%E5%BC%80%E5%8F%91%E8%A7%84%E8%8C%83/%E7%BC%96%E7%A0%81%E8%A7%84%E8%8C%83.md
• https://gist.github.com/zhuqling/a2700703d088b8746f0c

所有的命名都是以下面两种方式进行命名:

• PascalCasing(匈牙利命名法:每个词的第一个字母大写)
• camelCasing(骆驼命名法:第一个词的第一个字母小写,之后每个词的第一个字母大写)

注释

文件注释: 文件注释以如下方式进行,在扩展注释时(回车换行时)会自动添加注释行.

/******************************************************************** Description:This is a example class* Version: 1.0.0* Date: 20180218* Author: Hiram* Email: hiramtan@live.com* Copyright @ www.wikipedia.org*******************************************************************/

命名空间 类型 接口 方法名 属性 事件 字段 枚举:以"///"的方式注释,编辑器会自动完善注释,并且可以用生成工具直接生成代码注释文档.

/// <summary>/// 方法(Pascal)/// </summary>/// <param name="args">参数(Camel)</param>publicvoidMethod(intargs){//局部变量(Camel)intvariable=10;}

其他注释:以"//"的方式注释在上一行或行尾添加注释(比如局部变量,逻辑行)段落注释:以如下方式进行

/*       public void Method()       {       }*/

待办及高亮:在注释中添加"ToDo"高亮显示注释

命名空间

类型

• 结构体命名方式与类一致
• 泛型默认T
• 多个泛型根据反编译微软dll,建议命名T1,T2,T3,T4...

接口

接口定义以"I"开头,比如IInterface,IPlayer

方法

属性

属性都以Pascal方式命名

委托

微软官方建议添加以下两种后缀

• EventHandler
• Callback微软官方不建议添加以下后缀
• Delegate

事件

• 微软官方建议:事件参数添加后缀"EventArgs"
• 习惯命名:事件以On为前缀(比如OnClick)

字段

微软团队初期使用Camel方式命名私有字段,后来逐步采用下划线+Camel方式命名,这样做的好处是不必再识别字段是否是局部变量.

字段建议是非Public类型的,以属性替换公有的字段:这样外部访问更安全(readonly,const等除外),并且外部调用者全部使用Pascal命名方式调用对象逻辑.

微软官方只规定了public/protected以Pascal方式命名,对internal,private类型的字段没有说明,因此各种第三方规范和插件中对私有字段规范也不一致.

针对官方的示例代码,书写习惯,智能提示,代码补全和约定俗成的C#规范,建议private采用下划线+Camel方式命名,非Private字段采用Pascal方式命名.

参考微软官方命名规则,C#高级编程,Resharp命名规范,.Net源码命名规则,建议字段命名方式如下:

• public/protected/internal以Pascal方式命名
• private以下划线+Camel方式命名

publicreadonlyintField1;publicconstintField2=0;internalreadonlyintField3;internalconstintField4=0;privateint_field5;privatestaticint_field6;privatereadonlyint_field7;privateconstint_field8=0;

• 以m_为前缀的方式不建议(C++命名方式)
• 以类型为前缀的方式不建议(比如bool类型的字段以b为前缀,枚举以e为前缀)
• 以类型为后缀的方式不建议(比如单位列表unitList,直接取名为units)

枚举

参数

局部变量

局部变量可以使用var自动声明类型