1、程序规范1、 命名中使用英文名称，杜绝使用拼音、英文首字母组合。2、 命名空间、类命名定义采用英文首字母大写，如：UserInfo，接口采用：IUser3、 页面空间命名使用开头 3 字母前缀。详细见附表：4、 私有变量、局部变量采用首字母小写，后面的单词首字母大写，如：userName5、 公共变量及属性采用单词首字母大写，如：UserName6、 方法名称统一使用单词首字母大写，并使用动名词形式，如：SetUserName。方法中的参数采用私有变量的命名方式。7、 if、while、 for、foreach 等语句即使后面只有一句逻辑，也要使用大括号。8、 大括号“” 、 “”放在单独的行
2、中。9、 .cs 文件开头需使用注释说明建立者，建立日期等注释。/ =/ Author:/ Create date: / Description: / =10、 类、方法、属性注释，采用标准注释。即连续打三个“/”开发环境自动生成注释框架。11、 除非在类构造函数中（用于区别构造函数参数与类私有变量） ，否则避免使用 this 关键字引用类的私有变量。12、 常量命名全部使用大写单词，单词之间使用下划线“_”连接。13、 修饰符，如：public、protected 、private 等，在限定类或者方法的时候最小化作用范围。14、 在引用命名空间的时候，系统命名空间在上，自定义命名空间在下。
3、系统和自定义命名空间之间留空行。15、 在引用类、函数、变量时不能使用完全限定名，必须引用命名空间后使用。 （继承 Page 除外）16、 方法之间必须有空行隔开。17、 语句缩进，应使用 TAB 进行缩进，设置开发环境一个 TAB 显示宽度等于 4 个空格宽度。18、 程序行之间采用逻辑块之间增加空行，每行之间没有空行与都有空行会降低程序可读性。19、 页面文件命名采用单词首字母大写，如：UserList.aspx 其中页面推荐命名： 列表页面使用类似 XxxxxList.aspx 方式命名。 数据新增页面使用类似：XxxxxAdd.aspx 方式命名。 数据编辑页面使用类似：XxxxxEd
4、it.aspx 方式命名。 统计界面使用类似：XxxxxStat.aspx 方式命名。 详细数据浏览使用类似：XxxxxView.axpx 方式命名。 综合查询功能页面使用类似：XxxxxSearch.aspx 方式命名。 多语言化页面要在 App_GlobalResources、App_LocalResources 文件夹下面对应相应的文件名建立文本文件，如：UserList.aspx.txt，此文件描述需要多语言化的内容。注：英文全称存在简写的，可使用简写。如：Information 可使用 Info，Statistic 可使用 Stat。表示状态的 Status使用全称。尽量使用英文中原
5、有的简写，不要自创简写。更多请参见附录：数据库规范1、 数据库表、视图、存储过程命名按照如下格式：表：T_User ，视图 V_User，存储过程 P_UserList，主键 PK_UserId，外键 FK_外键表名_外键字段名，索引IX_LoginId。规则为开头简写大写字母加下划线加全称英文单词，英文单词首字母大写。2、 数据库语句中 SQL 关键字，系统默认参数、变量全部大写，数据类型除外，如：nvarchar(50)。3、 数据库存储过程参数采用+英文全称的命名方式，如：UserId，英文单词首字母大写。4、 多表交叉查询语句不使用表别名，使用完整的限定名。5、 查询语句中的字段大小写
6、于数据表设计时使用的大小写一样。6、 语句缩进，应使用 TAB 进行缩进，设置开发环境一个 TAB 显示宽度等于 4 个空格宽度。7、 不应在任何 Sql 语句中使用 SELECT * FROM ，必须使用完整的列名称。8、 代码中使用 BEGIN END 语句块，并缩进，提高可读性。9、 存储过程事务规则：在没有特殊需要自己控制回滚的情况下建议采用：SET XACT_ABORT ONBEGIN TRANSACTION这里是多表操作逻辑COMMIT TRANSACTION存储过程标准注释参考：- =- Author: - Create date: - Description: - =CREAT
7、E PROCEDURE - Add the parameters for the stored procedure here= , = ASBEGIN- SET NOCOUNT ON added to prevent extra result sets from- interfering with SELECT statements.SET NOCOUNT ON;- Insert statements for procedure hereSELECT , ENDGO控件命名注：该空间命名前缀仅适用于*.aspx 页面上面的控件 ID 的命名。如果是在*.aspx.cs 文件中自己写的动态生成控
8、件的命名，遵循一般的变量命名规则。类型 前缀 示例Label lbl lblUserNameTextBox tbxPanel pnlButton btnLinkLabel llbCheckBox cbxRadioButton rbnGroupBox gbxPictureBox pbxRepeater rptDataList dltGridView gdvDataGrid dtgListBox lbxCheckedListBox clbComboBox cmbListView ltvTreeView trvTabControl tbcDateTimePicker dtpMonthCalendar
9、 mcdHScrollBar hsbVScrollBar vsbTimer tmrSpliter splDomainUpDown dudNumericUpDown nudTrackBar tkbProcessBar prbRichTextBox rtbImageList imlHelpProvider hlpToolTip tltContextMenu ctmToolBar tlbStatusBar stbNotifyIcon ntiOpenFileDialog ofdSaveFileDialog sfdFolderBrowserDialog fbdFrontDialog ftdColorDi
10、alog cldPrintDialog ptdPrintPreviewDialog ppdPrintPreviewControl ppcErrorPrivider erpPrintDocument prdPageSetupDialog psdCrystalReportViewer crv附录：（如附录与正本中的规则规范冲突，请以正本为准。 ）一、 名称准则对于组成类库的元素（包括程序集、命名空间、类型、成员和参数），命名准则提供如何为这些元素选择合适的标识符的准则。选择符合这些准则的标识符可以提高您的库的可用性，并使用户相信您的库将不需要学习一组新的规则。 为了提供一致的开发人员体验，公共公开
11、的元素（如公共类和受保护的方法）必须遵守这些准则。然而，为在整个代码中保持一致性以及改进可维护性，应考虑在整个代码中始终使用这些约定。1、 大小写约定许多命名约定都与标识符的大小写有关。值得注意的是，公共语言运行库 (CLR) 支持区分大小写和不区分大小写的语言。本主题中描述的大小写约定可帮助开发人员理解和使用库。大小写样式下列术语描述了标识符的不同大小写形式。Pascal 大小写将标识符的首字母和后面连接的每个单词的首字母都大写。可以对三字符或更多字符的标识符使用 Pascal 大小写。例如：BackColor 大小写混合标识符的首字母小写，而每个后面连接的单词的首字母都大写。例如：back
12、Color 大写标识符中的所有字母都大写。例如：IO 标识符的大小写规则如果标识符由多个单词组成，请不要在各单词之间使用分隔符，如下划线（“_”）或连字符（“-”）等。而应使用大小写来指示每个单词的开头。 下列准则是用于标识符的通用规则。 对于由多个单词组成的所有公共成员、类型及命名空间名称，要使用 Pascal 大小写。注意，这条规则不适用于实例字段。由于成员设计准则中详细说明的原因，不应使用公共实例字段。 对参数名称使用大小写混合。下表汇总了标识符的大小写规则，并提供了不同类型标识符的示例。标识符 大小写方式 示例 类 Pascal AppDomain 枚举类型 Pascal ErrorL
13、evel 枚举值 Pascal FatalError 事件 Pascal ValueChanged 异常类 Pascal WebException 只读的静态字段 Pascal RedValue 接口 Pascal IDisposable 方法 Pascal ToString 命名空间 Pascal System.Drawing 参数 Camel typeName 属性 Pascal BackColor 首字母缩写词的大小写规则首字母缩写词是由术语或短语中各单词的首字母构成的单词。例如，HTML 是 Hypertext Markup Language 的首字母缩写。只有在公众广为认知和理解的情
14、况下，才应在标识符中使用首字母缩写词。首字母缩写词不同于缩写词，因为缩写词是一个单词的缩写。例如，ID 是 identifier 的缩写。通常情况下，库名不应使用缩写词。 注意可在标识符中使用的两个缩写词是 ID 和 OK。在采用 Pascal 大小写格式的标识符中，这两个缩写词的大小写形式应分别为 Id 和 Ok。如果在采用大小写混合格式的标识符中将这两个缩写词用作首个单词，则它们的大小写形式应分别为 id 和 ok。首字母缩写词的大小写取决于首字母缩写词的长度。所有首字母缩写词应至少包含两个字符。为了便于这些准则的实施，如果某一首字母缩写词恰好包含两个字符，则将其视为短型首字母缩写词。包含
15、三个或三个以上字符的首字母缩写词为长型首字母缩写词。下列准则为短型和长型首字母缩写词指定了正确的大小写规则。标识符大小写规则优先于首字母缩写词大小写规则。两字符首字母缩写词的两个字符都要大写，但当首字母缩写词作为大小写混合格式的标识符的首个单词时例外。例如，名为 DBRate 的属性是一个采用 Pascal 大小写格式的标识符，它使用短型首字母缩写词 (DB) 作为首个单词。又如，名为 ioChannel 的参数是一个采用大小写混合格式的标识符，它使用短型首字母缩写词 (IO) 作为首个单词。包含三个或三个以上字符的首字母缩写词只有第一个字符大写，但当首字母缩写词作为大小写混合格式的标识符的首
16、个单词时例外。例如，名为 XmlWriter 的类是一个采用 Pascal 大小写格式的标识符，它使用长型首字母缩写词作为首个单词。又如，名为 htmlReader 的参数是一个采用大小写混合格式的标识符，它使用长型首字母缩写词作为首个单词。如果任何首字母缩写词位于采用大小写混合格式的标识符开头，则无论该首字母缩写词的长度如何，都不大写其中的任何字符。例如，名为 xmlStream 的参数是一个采用大小写混合格式的标识符，它使用长型首字母缩写词 (xml) 作为首个单词。又如，名为 dbServerName 的参数是一个采用大小写混合格式的标识符，它使用短型首字母缩写词 (db) 作为首个单词
17、。复合词和常用术语的大小写规则不要将所谓的紧凑格式复合词中的每个单词都大写。这种复合词是指写作一个单词的复合词，如“endpoint”。例如，hashtable 是一个紧凑格式的复合词，应将其视为一个单词并相应地确定大小写。如果采用 Pascal 大小写格式，则该复合词为 Hashtable；如果采用大小写混合格式，则该复合词为 hashtable。若要确定某个单词是否是紧凑格式的复合词，请查阅最新的词典。下表列出了不是紧凑格式复合词的一些常用术语。术语先以 Pascal 大小写格式显示，后面的括号中的是其大小写混合格式。 BitFlag (bitFlag) FileName (fileNam
18、e) LogOff (logOff) LogOn (logOn) SignIn (signIn) SignOut (signOut) UserName (userName) WhiteSpace (whiteSpace)区分大小写大小写准则只是为了使标识符更易于阅读和辨认。不能将大小写规则用作避免库元素之间的命名冲突的手段。不要假定所有编程语言都区分大小写。事实并非如此。不能仅凭大小写区分名称。2、 通用命名约定通用命名约定讨论的是如何为库元素选择最适当的名称。这些准则适用于所有标识符。后面各节讨论特定元素（如命名空间或属性）的命名。选择名称请选择易读的标识符名称。例如，英文属性名称 Hori
19、zontalAlignment 比 AlignmentHorizontal 更具可读性。可读性比简洁性更重要。属性名称 CanScrollHorizontally 比 ScrollableX（指 X 轴，但意义不明确）更好。不要使用下划线、连字符或任何其他非字母数字字符。不要使用匈牙利表示法。匈牙利表示法是在标识符中使用一个前缀对参数的某些元数据进行编码，如标识符的数据类型。 避免使用与常用编程语言的关键字冲突的标识符。虽然符合 CLS 的语言必须提供将关键字用作普通字的方法，最佳做法不要求强制开发人员了解如何实现。对于大多数编程语言，语言参考文档都会提供语言所使用的关键字列表。下表提供了某些
20、常用编程语言的参考文档的链接。语言 链接 C# C# 参考 C+ C+ Language Reference Visual Basic Visual Basic 参考 缩写和首字母缩写词通常，不应使用缩写或首字母缩写词。这类名称的可读性较差。同样，要确定某个首字母缩写词是否已受到广泛认可也是很困难的。 有关缩写的大写规则，请参见首字母缩写词的大小写规则。不要将缩写或缩略形式用作标识符名称的组成部分。例如，使用 OnButtonClick 而不要使用 OnBtnClick。除非必要，不要使用任何未被广泛接受的首字母缩写词。语言特定的名称对于类型名称，应使用语义上有意义的名称而不要使用语言特定的关
21、键字。例如，名称 GetLength 比 GetInt 更好。在标识符的语义含义仅限于其类型的极少数情况下，应使用一般公共语言运行库 (CLR) 类型名称，而不要使用语言特定的名称。例如，将数据转换为 Int16 的方法应命名为 ToInt16 而不是 ToShort，因为 Short 是 Int16 的语言特定的类型名称。 下表显示的是公共编程语言和 CLR 的相应语言特定的类型名称。C# 类型名称 Visual Basic 类型名称 JScript 类型名称 Visual C+ 类型名称 Ilasm.exe 表示形式 CLR 类型名称 sbyte SByte sByte char int8
22、 SByte byte Byte byte unsigned char unsigned int8 Byte short Short short short int16 Int16 ushort UInt16 ushort unsigned short unsigned int16 UInt16 int Integer int int int32 Int32 uint UInt32 uint unsigned int unsigned int32 UInt32 long Long long _int64 int64 Int64 ulong UInt64 ulong unsigned _int6
23、4 unsigned int64 UInt64 float Single float float float32 Single double Double double double float64 Double bool Boolean boolean bool bool Boolean char Char char wchar_t char Char string String string String string String object Object object Object object Object 在标识符没有语义含义且参数的类型不重要的极少数情况下，应使用通用名称（如值
24、或项），而不要重复类型名称。3、 程序集和 DLL 的名称大多数情况下，程序集包含全部或部分可重用库，且它包含在单个动态链接库 (DLL) 中。一个程序集可拆分到多个 DLL 中，但这非常少见，在此准则中也没有说明。程序集和 DLL 是库的物理组织，而命名空间是逻辑组织，其构成应与程序集的组织无关。命名空间可以且经常跨越多个程序集。一定要为程序集 DLL 选择指示大的功能块（如 System.Data）的名称。程序集和 DLL 的名称不必对应于命名空间名称，但是在命名程序集时遵循命名空间名称这种做法是合理的。考虑按下面的模式命名 DLL：dll 其中 包含一个或多个以圆点分隔的子句。例如，Co
25、ntoso.WebControls.dll。4、 命名空间的名称为命名空间选择的名称应指示命名空间中的类型所提供的功能。例如，System.Net.Sockets 命名空间包含的类型允许开发人员使用套接字通过网络进行通信。 命名空间名称的一般格式如下：.(|). 例如，Microsoft.WindowsMobile.DirectX。使用公司名称作为命名空间的前缀以防止不同公司开发的命名空间具有相同的名称和前缀。在命名空间名称的第二级使用稳定的、与版本无关的产品名称。不要根据组织层次结构确定命名空间层次结构中的名称，因为公司的部门名称经过一段时间后可能会改变。命名空间名称是长期使用的、不会更改的
26、标识符。组织的不断发展和变化不应使命名空间名称过时。使用 Pascal 大小写格式，并用句点分隔命名空间各部分（如 Microsoft.Office.PowerPoint）。如果您的品牌采用了非传统的大小写，应遵循您的品牌所定义的大小写，即使它与常用的命名空间大小写相背离也如是。适当的时候可考虑使用复数命名空间名称。例如，使用 System.Collections 而不使用 System.Collection。但是，品牌名称和首字母缩写词属于此规则的例外情况。例如，使用 System.IO，而不要使用 System.IOs。命名空间和其中的类型不要使用相同的名称。例如，不要在将“Debug”用
27、作命名空间名称的同时，又在该命名空间中提供一个名为“Debug”的类。有些编译器要求对这种类型进行完全限定。命名空间和类型的名称冲突如果选择的命名空间或类型的名称与现有名称冲突，则库的用户将不得不对受影响的项的引用进行限定。在大多数开发情况中，都不应出现这种问题。本节提供的某些准则适用于下面的命名空间类别： 应用程序模型命名空间 基础结构命名空间 核心命名空间 技术命名空间组应用程序模型中的命名空间提供特定于应用程序中的某个类的功能集。例如，System.Windows.Forms 命名空间中的类型提供编写 Windows 窗体客户端应用程序所需的功能。System.Web 命名空间中的类型支
28、持编写基于 Web 的服务器应用程序。通常，在同一应用程序中不会使用不同应用程序模型中的命名空间，因此，这降低了名称冲突影响使用您的库的开发人员的可能性。基础结构应用程序提供专门的支持，很少在程序代码中进行引用。例如，程序开发工具所使用的 *.Designer 命名空间中的类型。*.Permissions 命名空间是基础结构命名空间的另一个示例。与基础结构命名空间中的类型的名称冲突不可能影响使用您的库的开发人员。核心命名空间是 System.* 命名空间（不包括应用程序命名空间和基础结构命名空间）。System 和 System.Text 都是核心命名空间的示例。应尽可能避免与核心命名空间中的
29、类型发生名称冲突。属于特定技术的命名空间将具有相同的第一和第二级标识符 (Company.technology.*)。应避免在技术命名空间中出现名称冲突。 命名空间一般准则不要引入宽泛的类型名称，如 Element、Node、Log 和 Message。在通常情况下，这样极可能导致类型名称冲突。应对宽泛的类型名称进行限定（例如 FormElement、XmlNode EventLog、SoapMessage）。应用程序命名空间准则不要在单个应用程序模型内为命名空间中的多个类型指定相同的名称。例如，如果要编写 Windows 窗体应用程序开发人员要使用的特殊控件库，则不应引入名为 Checkbo
30、x 的类型，因为该应用程序模型已存在同名类型 (CheckBox)。核心命名空间准则不要指定会与核心命名空间中的任何类型发生冲突的类型名称。例如，不要使用 Directory 作为类型名称，因为这会与 Directory 类型冲突。技术命名空间准则不要分配会与单个技术命名空间内的其他类型发生冲突的类型名称。不要引入会导致技术命名空间的类型与应用程序模型命名空间中的类型发生冲突的类型名称（除非该技术不用于该应用程序模型）。5、 类、结构和接口的名称通常，类型名称应该是名词短语，其中名词是由类型表示的实体。例如，Button、Stack 和 File 都具有名称，用于标识由类型表示的实体。从开发人
31、员的角度选择标识实体的名称；名称应反映使用场合。下面的准则适用于如何选择类型名称。 按照 Pascal 大小写格式，使用名词或名词短语（或偶尔使用形容词短语）为类、接口和值类型命名。不要为类名加前缀（如字母 C）。接口不适用此规则，它应以字母 I 开头。考虑在派生类的末尾使用基类名称。例如，从 Stream 继承的 Framework 类型以 Stream 结尾，从 Exception 继承的类型以 Exception 结尾。为接口名称加上字母 I 前缀，以指示该类型为接口。在定义类/接口对（其中类是接口的标准实现）时，一定要确保类和接口的名称除接口名称以字母 I 为前缀外，二者应完全相同。例
32、如，Framework 提供 IAsyncResult 接口和 AsyncResult 类。泛型类型参数的名称泛型是 .NET Framework 2.0 版的主要新功能。下面的准则适用于为泛型类型参数选择正确的名称。用描述性名称为泛型类型参数命名，除非单个字母的名称已完全可以自我说明而无需描述性名称。IDictionary 是一个符合此准则的接口的示例。对具有一个单字母类型参数的类型，考虑将字母 T 用作这些类型的类型参数名称。将字母 T 作为描述性类型参数名称的前缀。考虑在参数名称中指示置于类型参数上的约束。例如，约束于 ISession 的参数可称为 TSession。常见类型的名称下面
33、的准则提供的命名约定有助于开发人员了解某些类的使用场合。准则中提及的从某个其他类型继承的类型，指的是所有的继承者，而不只是直接继承的类型。例如，“向从 Exception 继承的类型添加 Exception 后缀”这一准则意味着在继承层次结构中具有 Exception 的任何类型都应该使用以 Exception 结尾的名称。 每条这样的准则还用来保留指定的后缀；除非类型满足该准则表述的条件，否则不应使用该后缀。例如，如果类型不是从 Exception 直接或间接继承的，则类型名称不能以 Exception 结尾。向自定义属性类添加 Attribute 后缀。ObsoleteAttribute
34、和 AttributeUsageAttribute 是符合此准则的类型名称。向在事件中使用的类型（如 C# 事件的返回类型）的名称添加 EventHandler 后缀。AssemblyLoadEventHandler 是符合此准则的委托名称。向不是事件处理程序的委托的名称添加 Callback 后缀。不要向委托添加 Delegate 后缀。向扩展 System.EventArgs 的类添加 EventArgs 后缀。不要从 System.Enum 类派生；使用当前所用语言支持的关键字。例如，在 C# 中应使用 enum 关键字。向从 System.Exception 继承的类型添加 Excep
35、tion 后缀。向实现 System.Collections.IDictionary 或 System.Collections.Generic.IDictionary 的类型添加 Dictionary 后缀。注意，System.Collections.IDictionary 是特定类型的集合，但此准则的优先级高于以下更为一般的集合准则。向实现 System.Collections.IEnumerable、System.Collections.ICollection、System.Collections.IList、System.Collections.Generic.IEnumerable、S
36、ystem.Collections.Generic.ICollection 或 System.Collections.Generic.IList 的类型添加 Collection 后缀。向从 System.IO.Stream 继承的类型添加 Stream 后缀。向从 System.Security.CodeAccessPermission 继承的类型或实现 System.Security.IPermission 的类型添加 Permission 后缀。枚举的名称不要在枚举值名称中使用前缀。例如，不要对 ADO 枚举使用 ad 之类的前缀，也不要对多格式文本枚举使用 rtf 之类的前缀，依此类推
37、。这还意味着不应在枚举值名称中包含枚举类型名称。下面的代码示例演示了不正确的枚举值命名。C# public enum TeamsTeamsAlpha,TeamsBeta,TeamsDelta不要将 Enum 用作枚举类型的后缀。不要在标志枚举的名称中添加 Flags 作为后缀。对枚举使用单数名称，除非枚举值是位域。对使用位域值的枚举（也称为标志枚举）使用复数名称。6、 类型成员的名称类型包含以下几种成员： 方法 属性 字段 事件本节中的准则有助于类库设计者为成员选择与 .NET Framework 一致的名称。方法的名称使用动词或动词短语作为方法的名称。通常，方法对数据进行操作，因此，使用动词
38、描述方法的操作可使开发人员更易于了解方法所执行的操作。定义由方法执行的操作时，应从开发人员的角度仔细选择明确的名称。不要选择描述方法如何执行其操作的动词，也就是说，不要使用实现细节作为方法名称。属性的名称使用名词、名词短语或形容词作为属性的名称。名词短语或形容词适合于属性，因为属性保存数据。 不要使用与 Get 方法同名的属性。例如，不要将一个属性命名为 EmployeeRecord，又将一个方法命名为 GetEmployeeRecord。开发人员会不知道使用哪个成员来完成其编程任务。使用肯定性短语作为布尔值属性的名称（如使用 CanSeek 而不使用 CantSeek）。此外，还可以为布尔值
39、属性添加前缀（如 Is、Can 或 Has），但要注意使用得当。考虑为属性提供与其类型相同的名称。如果某个属性已强类型化为某个枚举，则该属性可与该枚举同名。例如，如果有一个名为 CacheLevel 的枚举，则返回其中一个枚举值的属性也可以命名为 CacheLevel。事件的名称使用动词或动词短语作为事件的名称。在为事件命名时，使用现在时或过去时表示时间上的前后概念。例如，在窗口关闭之前引发的关闭事件可命名为“Closing”，在窗口关闭之后引发的关闭事件可命名为“Closed”。不要使用“Before”或“After”作为前缀或后缀来指示之前和之后发生的事件。使用后缀 EventHandle
40、r 命名事件处理程序（用作事件类型的委托）。在事件处理程序签名中使用命名为“sender”和“e”的两个参数。sender 参数的类型应为 Object，e 参数应是 EventArgs 的实例或继承自 EventArgs 的实例。使用 EventArgs 后缀命名事件参数类。字段的名称字段的命名准则适用于静态公共字段和静态受保护字段。不要定义公共实例字段或受保护实例字段。有关更多信息，请参见字段设计。在字段名称中使用 Pascal 大小写格式。使用名词或名词短语作为字段的名称。不要在字段名称中使用前缀。例如，不要使用 g_ 或 s_ 来区分静态字段和非静态字段。7、 参数名选择适当的参数名称
41、可极大改善库的可用性。适当的参数名称应指示该参数会影响的数据或功能。 对参数名称使用 Camel 大小写。使用描述性参数名称。在大多数情况下，参数名称及其类型应足以确定参数的用法。考虑使用反映参数含义的名称而不是反映参数类型的名称。在开发人员工具和文档中，参数的类型通常都是可见的。通过选择一个说明参数的用法或含义的名称，可以向开发人员提供有价值的信息，帮助他们找到任务所需的成员，也有助于向成员传递正确的数据。8、 资源的名称本主题中准则适用于可本地化的资源，如错误信息和菜单文本。 在资源键中使用 Pascal 大小写格式。提供描述性标识符，而不要提供短标识符。尽量保持标识符的简洁性，但不要牺牲
42、可读性。不要使用公共语言运行库 (CLR) 编程语言中特定于语言的关键字。在命名资源中只能使用字母数字字符和下划线。使用点分隔符（“.”）以清晰的层次结构表示标识符。例如，Menus.FileMenu.Close.Text 和 Menus.FileMenu.Close.Color 等名称符合此准则。对异常消息资源使用下面的命名约定。资源标识符应由异常类型名称加上异常的短标识符构成，二者之间以点分隔。例如，ArgumentException.BadEnumValue 符合此准则。二、 类型设计准则本节提供的准则可帮助库设计人员从各种设计中做出选择，并正确实现类型。1、 类型和命名空间下列准则可帮
43、助您组织类型和命名空间，以便可以方便地查找和使用它们。 使用命名空间将类型组织到相关功能区域的层次结构中。避免使用非常深的命名空间层次结构。这样的层次结构难于浏览，因为用户需要频繁沿层次结构反向移动。避免使用过多的命名空间。应将在同一方案中使用的类型尽可能放在同一命名空间中。用户在开发常见方案时，不应需要导入很多的命名空间。避免将设计用于高级方案的类型与设计用于常见编程任务的类型放入同一命名空间中。一般情况下，应将高级类型放入一般命名空间内的某个命名空间中，并将 Advanced 用作该命名空间的名称的最后一个标识符。例如，与 XML 序列化相关的常用类型位于 System.Xml.Seria
44、lization 命名空间中，而高级类型则位于 System.Xml.Serialization.Advanced 命名空间中。定义类型时要指定类型的命名空间。未指定命名空间的类型放在全局命名空间中。由于全局命名空间中的类型未在特定于功能的命名空间中，因此使用开发工具很难找到这些类型。此外，全局命名空间中的名称冲突问题也无法解决。有关更多信息，请参见命名空间的名称。a、标准子命名空间子命名空间是命名空间中的命名空间。使用子命名空间可以限制开发人员在查找适用于常见编程任务的正确类型时所必须检查的类型数量。下列准则可帮助将某些特殊类型组织到主要功能命名空间下的已知命名空间中。使用带有 .Desig
45、n 后缀的命名空间来包含为基命名空间提供设计时功能的类型。例如，与 Windows 窗体组件的设计时配置和行为相关的类型位于 System.Windows.Forms.Design 命名空间中。使用带有 .Permissions 后缀的命名空间来包含为基命名空间提供自定义权限的类型。使用带有 .Interop 后缀的命名空间来包含为基命名空间提供互操作功能的类型。.Interop 子命名空间中的类型允许软件与 Microsoft 组件对象模型 (COM) 对象等旧版代码进行交互。对主互操作程序集 (PIA) 中的所有代码使用带有 .Interop 后缀的命名空间。2、 在类和结构之间选择类是引
46、用类型，而结构是值类型。引用类型在堆中分配，内存管理由垃圾回收器处理。值类型在堆栈上或以内联方式分配，且在超出范围时释放。通常，值类型的分配和释放开销更小。然而，如果在要求大量的装箱和取消装箱操作的情况下使用，则值类型的表现就不如引用类型。有关更多信息，请参见装箱和取消装箱（C# 编程指南）。有关值类型和引用类型的更多信息，请参见通用类型系统概述。如果类型的实例不大，且通常生存期短或嵌入其他对象，则考虑定义结构而不是类。不要定义结构，除非该类型具备以下所有特征： 它在逻辑上表示单个值，与基元类型（整型、双精度型等）类似。 它的实例大小小于 16 字节。 它是不可变的。 它将不必频繁被装箱。 如
47、果这些条件中的一个或多个没有满足，则创建引用类型而不是结构。不遵守此准则会对性能产生负面影响。3、 在类和接口之间选择接口定义实施者必须提供的一组成员的签名。接口不能提供成员的实现细节。例如，ICollection 接口定义与使用集合相关的成员。实现该接口的每个类都必须提供这些成员的实现细节。类可以实现多个接口。类定义每个成员的成员签名和实现细节。Abstract（在 Visual Basic 中为 MustInherit）类的行为在某方面与接口或普通类相同，即可以定义成员，可以提供实现细节，但并不要求一定这样做。如果抽象类不提供实现细节，从该抽象类继承的具体类就需要提供实现。 虽然抽象类和接
48、口都支持将协定与实现分离开来，但接口不能指定以后版本中的新成员，而抽象类可以根据需要添加成员以支持更多功能。优先考虑定义类，而不是接口。在库的以后版本中，可以安全地向类添加新成员；而对于接口，则只有修改现有代码才能添加成员。 请使用抽象（在 Visual Basic 中为 MustInherit）类，而不要使用接口来分离协定与实现。如果需要提供多态层次结构的值类型，则应定义接口。值类型必须从 ValueType 继承，并且只能从 ValueType 继承，因此值类型不能使用类来分离协定和实现。这种情况下，如果值类型要求多态行为，则必须使用接口。请考虑定义接口来达到类似于多重继承的效果。如果一个
49、类型必须实现多个协定，或者协定适用于多种类型，请使用接口。例如，IDisposable 是由许多不同情况下使用的类型实现的。如果要求从基类继承的类可处置，会使类层次结构很不灵活。MemoryStream 等应从其父类继承基于流的协定的类，不可能还是可处置的。4、 抽象类设计任何情况下，抽象类都不应进行实例化，因此，正确定义其构造函数就非常重要。确保抽象类功能的正确性和扩展性也很重要。下列准则有助于确保抽象类能够正确地设计并在实现后可以按预期方式工作。不要在抽象类型中定义公共的或受保护的内部（在 Visual Basic 中为 Protected Friend）构造函数。具有 public 或 protected internal 可见性的构造函数用于能进行实例化的类型。任何情况下抽象类型都不能实例化。应在抽象类中定义一个受保护构造
