C#编码标准－－命名约定和风格
2024-07-21 02:19:42
供稿：网友
命名约定和风格
1． 使用pascal的命名规范命名类型和方法的名字。
public class someclass
{
public somemethod(){}
}
2． 使用camel命名规范命名局部变量和方法的参数。
int number;
void mymethod(int somenumber)
{}
3． 在命名接口的时候使用i作为前缀。
interface imyinterface
{...}
4． 私有成员变量使用m_作为前缀。
public class someclass
{
private int m_number;
}
5． 自定义的属性类使用attribute作为其后缀。
6． 自定义的异常类使用exception作为其后缀。
7． 在命名方法的时候使用动宾结构的短语，比如：showdialog()。
8． 有返回值的方法应该有一个可以描述其返回值的名字，比如：getobjectstate()。
9． 使用有意义的变量名称。
10． 使用c#的预定义的类型而不使用system命名空间中其别名来申明变量。
使用object 而不是 object
使用string 而不是 string
使用 int 而不是 int32
11． 通常情况下，类型使用大写字母。当处理.net的类型的时候使用type作为其后缀。
//正确的是：
public class linkedlist<k,t>
{…}
//避免使用：
public class linkedlist<keytype,datatype>
{…}
12． 使用有意义的命名空间，比如使用公司的名称以及产品的名称。
13． 避免使用完全限定名。而使用using语句替换之。
14． 避免将using语句写在命名空间的内部。
15． 将所有的框架定义的命名空间为一组，自定义的和第三方的命名空间放在另一组。
using system;
using system.collections.
using system.componentmodel;
using system.data;
using mycompany.
using mycontrols;
16． 使用委托的引用替换显式的委托实例。
delegate void somedelegate();
public void somemethod()
{…}
somedelegate somedelegate = somemethod;
17． 保持严格的缩进风格。
a. 使用3个空格缩进
b. 不要使用tabs或者其他不标准的缩进，比如1、2、4个空格。
18． 在编写注释的时候注释的缩进和编码的缩进必须是相同级别的。
19． 所有的注释都要通过拼写检查，错误的拼写是粗糙的开发。（针对汉语则要语句通顺易于理解）
20． 所有的成员变量都应该声明在顶部，同时使用一个空行来将他们和属性以及方法分开。
public class myclass
{
int m_number;
string m_name;
public void somemethod1()
{}
public void somemethod2()
{}
}
21． 尽可能在第一次使用局部变量的时候申明它。
22． 文件名称应该可以反映出它所包含的类。
23． 当使用不完整的类并且将部分分配到每个文件中，用p+序数作为后缀命名文件。
// in myclassp1.cs
public partial class myclass
{…}
// in myclassp2.cs
public partial class myclass
{…}
24． 总是将大括号放在一个新行上。
25． 匿名方法和一般（正规）的方法代码使用相似的代码布局
a. 规定：大括号（方法体的括号）必须使用新行
delegate void somedelegate(string somestring);
// 正确的是：
public void invokemethod()
{
somedelegate somedelegate = delegate(string name)
{
messagebox.show(name);
};
somedelegate(“juval”);
}
// 避免使用：
public void invokemethod()
{
somedelegate somedelegate = delegate(string name){ messagebox.show(name);};
somedelegate(“juval”);
}
26． 在匿名无参方法中要使用空的括号。
a. 如果匿名方法有可能被使用在任何委托中那么可以省略括号。
delegate void somedelegate();
// 正确的方法是：
somedelegate somedelegate1 = delegate()
{
messagebox.show(“hello”);
}
// 避免使用：
somedelegate somedelegate1 = delegate
{
messagebox.show(“hello”);
}
