大小写约定

标识符的大小写规则

PascalCasing：如HtmlTag  IOStream

camelCasing：如htmlTag  ioStream

• 要把PascalCasing用于由多个单词构成的名字空间、类型、以及成员的名字；
• 要把camelCasing用于参数的名字。

通用命名约定

单词的选择

对框架中标识符的名字来说，很重要的一点是一目了然。

名字的意思清楚比长度短更重要。名字应该与场景、系统的逻辑组成或物理组成以及为人熟知的概念相对应，而不应该与技术或框架相对应。

• 要为标识符选择易于阅读的名字；
• 要更看重可读性，而不是更看重简短性；
• 不要使用下划线、连字符以及其他任何既非字母也非数字的字符；
• 不要使用匈牙利命名法；
• 避免使用与广泛使用的编程语言的关键字有冲突的标识符。

使用单词缩写和首字母缩写词

一般来说，不要在标识符中使用单词缩写或首字母缩写：宁可名字长一点，也不要别人看不懂。  尤其不要使用未被广泛接受的单词缩写和首字母缩写词。

• 不要使用缩写词或缩略词作为标识符名字的一部分
  用GetWindow  不用GetWin
• 不要使用未被广泛接受的首字母缩写词
  多谓广泛接受：用搜索引擎在网上搜索该首字母缩写词，如果返回的前几个结果与期望相符，那么该首字母缩写词才有资格被称为众所周知。

避免使用语言特有的名字

• 要给类型名使用语义上有意义的名字，而不要使用特有的关键字
  GetLength比GetInt要好
• 要使用CLR的通用类型名，而不要使用语言特有的别名
• 要使用常见的名字，比如value或item，而不要重复类型的名字

为已有API的新版本命名

当用新类型和新成员接替或取代已有的类型或成员时，如何选择名字：

• 使用与旧API相似的名字
• 要优先使用后缀而不是前缀来表示已有API的新版本
  这样有助于在浏览文档或使用Intellisense时发现新版本：按字母排序
• 可以考虑使用全新但有意义的标识符
• 要使用数字后缀来表示已有API的新版本
  有些名字（或工业标准）不宜添加后缀或改名
• 不要在标识符中使用“Ex”“New”等类似的后缀来区分相同API的不同版本
• 要在引入64位整数（long）而非32位整数进行操作的新版本API时使用“64”后缀，反之亦然。

程序集和DLL的命名

程序集是一个部署单元，同时还代表托管代码程序的身份。虽然程序集可以分布一个或多个文件中，但一般来说一个程序集仅与一个DLL相对应。

名字空间与DLL程序集的区别：

名字空间：一组逻辑实体

DLL和程序集：打包和部署时的一个单

• 要为程序集和DLL选择提示性的名字，比如System.Data，这样很容易就知道它的大致功能。
• DLL命名：<Company>.<Component>.dll

名字空间的命名

<Company>.(<Product>|<Technology>)[.<Feature>][.<Subnamespace>]

• 要用公司名称作为名字空间的前缀，不要用缩写
• 要用稳定的与版本无关的产品名称作为名字空间的第二层
• 不要根据公司的组织架构来决定名字空间的层次结构，因为公司内部组织的名称一般来说不会持续太长的时间
• 要使用PascalCasing大小写风格，并用点号来分隔名字空间的各部分。
  如Microsoft.Office.PowerPoint
• 考虑适当的时候在名字空间中使用复数形式。  首字母缩写词例外
  System.Collections
  System.IO
• 不要用相同的名字来命名名字空间与位于该名字空间中的类型
  如：不要将名字空间命名为Debug，然后又在该名字空间中提供一个名为Debug的类。

名字空间和类型冲突

• 不要引入太一般化的类型名，比如Element、Node、Log以及Message。

不同类型的名字空间，有不同的规范来避免类型名的冲突：

• 应用程序模型名字空间（application model namespace）
  属于单个应用程序模型的名字空间经常一起使用，但是它们几乎不合属于其他应用程序模型的名字空间一起使用
  System.Windows*
  System.UI*
• 基础设施名字空间（infrastructure namespace）
  此类别包含一些在开发常用应用程序时很少会导入的名字空间
• 核心名字空间（core namespace）
  包含了所有的System名字空间，但应用程序模块名字空间和基础设施名字空间除外。  包括System、System.IO、System.Xml以及System.Net等等
• 技术名字空间组（technology namespace group）
  此类别包含所有那些以相同的两个前缀（<Company>.<Technology>*）开始的名字空间。

类、结构和接口的命名

一般来说类型名应该是名词词组。如果无法为类型找到一个名词词组，那么应该重新考虑类型的总体设计。

另一个中重要的考虑因素：最易于识别的名字应该用于最常用的类型。

最常用的类型名应该反映出使用场景，而不是继承层次。

• 要用名词词组来给类型命名。使用PascalCasing风格
• 不要给类名加前缀
  只有接口才能（可以）被加前缀“I”，那是因为.NET框架受到COM及Java的影响
• 考虑让派生类的名字以其基类结尾
  public class FileStream : Stream {...}
• 要确保一对类/接口的名字只差一个“I”前缀，如果该类是该接口的标准实现。
  public interface IComponent {...}
  public class Component : IComponent {...}

泛型类型参数的命名

• 要用描述性的名字来命名
• 考虑用T来命名参数类型
• 要给描述性的类型参数名加上T前缀
• 考虑在类型参数中显示出施加于该类型参数上的限制

枚举类型的命名

• 要用单数名词来命名枚举类型，除非它表示的是位域（bit field）
• 不要给枚举类型的名字添加“Enum”后缀，也不要添加“Flag”、“Flags”等后缀
• 不要给枚举类型值的名字添加前缀
  此规范与C++中通常所使用的恰好相反。在C++中给枚举的每个成员加上完成的限定符是很重要的，因为它们可能在枚举名的作用域之外被访问。但是在托管代码中，枚举成员只能通过枚举名的作用域来访问。

类型成员的命名

类型：方法、属性、事件、构造函数、字段

方法的命名

要尽量根据方法所对应的任务来给它们命名，而不要根据一些实现细节。

• 要用动词或动词词组来命名方法

属性的命名

• 要用名词、名词词组或形容词来命名属性
• 不要让属性名看起来与“Get”方法的名字相似
• 要用肯定性的短语（CanSeek而不是CantSeek）来命名布尔属性
• 考虑用属性的类型名来命名属性
  public enum Color {...}
  public class Control
  {
      public Color Color
      {
          get {...}
          set {...}
      }
  }

事件的命名

• 要用动词或动词短语来命名事件
  事件总是表示一些动作，要么正在发生，要么已经发生
• 要用现在时和过去时来赋予事件名之前和之后的概念
  窗口关闭之前发生的close事件：Closing
  窗口关闭之后发生的close时间：Closed
• 不要用Before和After前缀或后缀来区分前置和后置事件
• 要在命名事件处理函数（用作事件类型的委托）时加上“EventHandler”后缀
• 要在事件处理函数中用sender和e作为两个参数的名字
  sender：触发事件的对象，在整个.NET框架中，sender为object类型
• 要在命名事件的参数类型时加上“EventArgs”后缀

字段的命名

• PascalCasing风格
• 名词或名词短语
• 不要给字段名添加前缀

参数的命名

• camelCasing风格
• 要使用描述性的参数名
  参数名要具备足够的描述性，使得在大多数情况下，用户根据参数的名字和类型就能够确定它的意思
• 考虑根据参数的意思而不是参数的类型来命名参数

资源的命名

本地化的资源就好比是属性，可以通过特定的对象来引用。因此，它的命名规范与属性的相似。

• 要在命名属性关键字（resource key）时使用PascalCasing大小写风格
• 要使标识符的名字具有描述性而不是使名字变短
• 不要使用各主要CLR编程语言特有的关键字
• 要在命名资源时使用字母、数字和下划线
• 要用点号来给标识符清楚地划分层次
• 要在为异常消息资源命名是遵循下面的命名约定：
  资源标识符应该是异常的类型名加一个简短的异常标识符，之间以点号分隔

• 调用基类上已被其他方法重写的方法

  1 public override void GetInfo()
  2 {
  3 base.GetInfo(); // 调用基类上的GetInfo方法
  4 }

• 指定创建派生类实例时应用的基类构造函数

  1 public MyDerived() : base() // 调用基类的构造函数
  2 {}

1 class MyType
2 {
3 public static explicit operator MyType(int i)
4     {
5 // 从int转换到MyType类型的代码
6     }
7 }

显式转换运算符必须通过类型转换调用

1 int i;
2 MyType x = (MyType)i; // int到MyType类型的转换需要进行类型转换

    如果转换操作可能导致异常或信息丢失，则应用explicit关键字标记它。
    implicit：用于声明用户定义的隐式转换运算符 

1 class MyType
2 {
3 public static implicit operator int(MyType m)
4     {
5 // 从MyType转换到int类型的代码
6     }
7 }

1 MyType x;
2 int i = x;  // 隐式地调用MyType的MyType到int类型的转换运算符

隐式转换可以通过消除不必要的类型转换来提高源代码的可读性。
    一般情况下，调用某一个隐式转换时，应当绝不会引发异常，并且不会造成信息丢失。否则，应将其标记为explicit。
方法参数关键字
    如果声明方法的参数时没有指明ref或out，该参数将具有与该方法相关的值。这个值在方法中能被更改，但是当程序返回到调用过程时，这种改动不会被保留。

    params：用于指定在参数数目可变时带有参数的方法参数
    在方法声明中的params关键字之后不允许引入任何其他参数，但在其前面可以有其他参数。而且在方法声明中只允许使用一个params关键字。

 1 public static void UseParams(params int[] list)
 2 {
 3 for(int i = 0; i < list.Length; i++)
 4     {
 5         Console.WriteLine(list[i]);
 6     }
 7 }
 8
 9 public static void Main()
10 {
11     UseParams（1,2,3）;
12 int[] myArray = new int[3] { 10,11,12 };
13     UseParams(myArray);
14 }

    ref、out  使方法可以引用传递到该方法的那一个变量，当程序转至调用方法时，在方法中对参数所做的任何改动都将传给该变量。
    ref参数的值将被传递到ref参数，故必须首先初始化；而out参数不然，它的值不会被传递到该out参数，故不必首先初始化，但它必须在方法返回以前为out参数赋值。
    属性不是变量，不能作为ref/out参数。

一个成功的通用框架必须是为广大具有不同的需求、技能和背景的开发人员而设计的。框架设计师面临的最大挑战是为这些多样化的用户群提供即简单又功能强大的框架。

• 要设计即功能强大又易于使用的框架。
  80/20原则。 要把精力集中在框架中使用最为频繁的部分（20%）
• 要明确地为具有不同编程风格、需求、技能以及使用不同编程语言的开发人员设计框架。
• 要了解哪些使用多语言框架的广大开发人员。
  我们往往会只为自己设计API，而没有清楚地考虑用户的真正需求。

渐进框架

针对不同的使用场景，为不同的开发团体提供不同的产品，这种多框架的方法在某种程度上说是成功的，比如MS有Visual Basic程序库，有Win32程序库，也有MFC和ATL，但它也存在严重的缺点：多框架使得使用某个框架的开发人员难以将他们的知识转移到下一个技能等级或使用场景（这通常需要另一个框架）。

• .NET框架所做的是把VB、MFC、ATL、ASP等这些模型统一起来。无论开发人员使用何种编程语言或者选择何种编程模型，可供使用的API始终都是一致的。
  一个更好的方法是提供渐进框架（Progresive framework）。  从无到有，慢慢积累知识，并应用到以后更高级的使用场景中去。
• .NET框架就是一个渐进框架。
  渐进框架的目标是覆盖广大的开发人员，但并不是所有可能的开发人员。
  这也应了没有十全十美这句话：不可能满足每一个开发人员的需求。

框架设计的基本原则：

对用户而言，真正的开发效率来自能够轻易地创造非凡的产品，而并非来自能够轻易地创造垃圾。

1. 场景驱动设计原则
2. 低门栏原则
3. 自说明对象原则
4. 分层架构原则

• 考虑对框架进行分层，使高层API能提供最佳的开发效率，低层API能提供最强大的功能和最丰富的表现力。
  通俗地讲，象我这样的菜鸟只能用高层API，太低层都不懂，而牛人们都是想用也更愿意用低层API的强大功能的（个人意见）。ps：这边的高层跟低层不是指高深的意思。而是从易用性方面考虑的！
• 避免把低层API和高层API混在同一名字空间中，如果低层API非常复杂的话（即包含了许多类型）。
• 要确保单个特性域中不同的层能很好的集成在一起。

4. TextBox控件

文本框的主要用途是让用户输入文本，用户可以输入任何字符，也可以限制用户只输入数值。

.NET Framework内置了两个基本控件来提取用户输入的文本：TextBox和RichTextBox。这两个控件都派生于TextBoxBase，而TextBoxBase又派生于Control。

TextBoxBase提供了在文本框中处理文本的基本能力，例如选择文本、剪切和从剪切板上粘帖，以及许多事情。

4.1 TextBox控件的属性

常用属性：

• CausesValidation：当控件的这个属性为true，且该控件获得了焦点时，会引发两个事件：Validating和Validated。可以处理这些事件，以便验证失去焦点的控件中数据的有效性。
• CharacterCasing：这个值表示TextBox是否会改变输入的文本的大小写。可能的值有：

1. Lower：文本框中输入的所有文本都转换为小写；
2. Normal：不变；
3. Upper：都转换为大写。

• MaxLength：这个值指定输入到TextBox中的文本的最大字符长度。如果设为0，表示最大字符长度仅受限于可用的内存。
• Multiline：表示该控件是否是一个多行控件。多行控件可以显示多行文本。
• PasswordChar：指定是否用密码字符替换在单行文本框中输入的字符。如果Multiline属性为true，这个属性就不起作用。
• ReadOnly：这个Boolean值表示文本是否为只读。
• ScrollBars：指定多行文本框是否显示滚动条。
• SelectedText：在文本框中选择的文本。
• SelectionLength：在文本中选择的字符数。如果这个值设置得比文本中的字符数大，则控件会把它重新设置为字符总数减去SelectionStart的值。
• SelectionStart：文本框中被选中文本的开头。
• WordWrap：指定在多行文本框中，如果一行的宽度超出了控件的宽度，其文本是否应自动换行。

4.2 TextBox控件的事件

TextBox提供了以下所示的事件：

• Enter、Leave、Validating、Validated：这4个事件按照列出的顺序引发。它们统称为焦点事件，当控件的焦点发生改变时引发，但有两个例外：Validating和Validated仅在控件接收了焦点，且其CausesValidation属性设置为true时引发。接收焦点的控件引发事件的原因是有时即使焦点改变了，我们也不希望验证控件的有效性。
• KeyDown、KeyPress、KeyUp：这三个事件称为“键事件”。它们可以监视和改变输入到控件中的内容。KeyDown和KeyUp接收与所按下键对应的键码，这样就可以确定是否按下了特殊的键Shift或Control和F1。另一方面，KeyPress接收与键对应的字符。这表示字母a的值与A的值不同。
• Change：只要文本框的文本发生了改变，就会引发该事件。

2. Button控件

按钮主要用于执行3类任务：

• 用某种状态关闭对话框（如OK和Cancel按钮）。
• 给对话框上输入的数据执行操作（如，输入一些搜索条件后，单击Search）。
• 打开另一个对话框或应用程序（如Help按钮）。

2.1 Button控件的属性：

Buttom类最常用的属性，它们都是在ButtonBase基类中定义的。

• FlatStyle：改变按钮的样式。
• Enabled：把Enabled设置为false，则该按钮就会灰显，单击它，不会起任何作用。此属性派生于Control。
• Image：可以指定一个在按钮上显示的图像（位图、图标等）。
• ImageAlign：按钮上图像的显示位置。

2.2 Button控件的事件：

private void button1_Click(object sender, EventArgs e)

{...}

对于Click事件，第一个参数Object sender包含被单击的控件。另一个参数EventArgs e包含所发生事件的信息。

3. Label和LinkLabel控件

Label控件（标签）是一个简单的控件，其用途只有一个：在窗体上显示文本。

.NET Framework包含两个标签控件，它们可以用两种截然不同的方式显示：

• Label是标准的Windows标签。
• LinkLabel以Internet链接的方式显示（超链接）。

尽管Label通常不需要添加任何事件处理代码，但它也支持事件。

Label控件常用的属性：

• BorderStyle：指定标签边框的样式。默认为无边框。
• FlatStyle：控制显示控件的方式。
• Image：指定要在标签上显示的图像（位图、图标等）。
• ImageAlign：图像显示在标签的什么位置。
• LinkArea：（只用于LinkLabel）文本中显示为链接的部分。
• LinkColor：（只用于LinkLabel）链接的颜色。
• Links：（只用于LinkLabel）LinkLabel可以包含多个链接。利用这个属性可以查找需要的链接。控件会跟踪显示文本中的链接，不能在设计期间使用。
• LinkVisited：（只用于LinkLabel）把它设置为true，单击控件，链接就会显示为另一种颜色。
• TextAlign：文本显示在控件中的什么位置
• VisitedLinkColor：（只用于LinkLabel）用户单击LinkLabel后控件的颜色

在使用Windows窗体时，就是在使用System.Windows.Forms命名空间。

.NET中的大多数控件都派生于System.Windows.Form.Control类。这个类定义了控件的基本功能。还有一些控件称为定制或用户控件，派生于另一个类System.Windows.Forms.UserControl。这个类本身派生于Control类，提供了创建控件所需要的功能。另外，用于设计Web用户界面的控件派生于另一个类System.Web.UI.Control。

1.1 属性

所有控件都有许多属性，用于处理控件的操作。

下面是Control类最常见的属性：

Anchor：指定当控件的容器的大小发生变化时，该控件如何响应。

BackColor：背景色

Bottom：指定控件的底部距离窗口的顶部有多远。这与指定控件的高度不同

Dock：可以使控件停靠在窗口的边界上

Enabled：把Enable设为true通常表示该控件可以接收用户的输入。把Enable设置为false通常表示不能接收用户的输入

ForeColor：前景色

Height：控件从底部到顶部的距离（是控件本身的距离）

Left：控件的左边界到窗口左边界的距离

Name：控件的名称，这个名称可以在代码中用于引用该控件

Parent：控件的父控件

Right：控件的右边界到窗口右边界的距离

TabIndex：控件在容器中的标签顺序号

TabStop：指定控件是否可以用Tab键访问

Tag：这个值通常不由控件本身使用，而是在控件中存储该控件的信息。当通过Windows Form设计器给这个属性赋值时，就只能给它赋一个字符串值

Top：控件的顶部距离窗口顶部的距离

Visible：指定控件是否在运行期间可见

Width：控件的宽度

另外，.NET的所有内部控件都使用Text属性来设置显示的文本。

1.2 控件的定位、停靠和对齐

在Visual Studio 2005中，窗体设计器默认改为使用栅格状的界面，并使用捕捉线来定位控件，使控件整齐地排列在界面上。

在窗体设计中，Anchor和Dock属性特别有用。

Anchor属性可以指定如果控件重新设置了大小，就根据控件的边界锁定它，或者其大小不变，当根据窗口的边界来锚定它的位置。

Dock属性用于指定控件应停放在容器的边框上。如果用户重新设置了窗口的大小，该控件将继续停放在窗口的边框上。

1.3 事件

下面所列的是Control类所定义的最常见的事件：

Click：在单击控件时引发。在某些情况下，这个事件也会在用户按下Enter键时引发。

DoubleClick：在双击控件时引发。处理某些控件上的Click事件，例如Button控件，表示永远不会调用DoubleClick事件。

DragDrop：在完成拖放操作时引发。换言之，当一个对象被拖到控件上，然后用户释放鼠标按钮后，引发该事件。

DragEnter：在被拖动的对象进入控件的边界时引发。

DragLeave：在被拖动的对象移出控件的边界时引发。

DragOver：在被拖动的对象放在控件上时引发。

KeyDown：当控件有焦点时，按下一个键时引发该事件，这个事件总是在KeyPress和KeyUp之前发生。

KeyPress：当控件有焦点时，按下一个键发生该事件，这个事件总是在KeyDown之后、KeyUp之前引发。KeyDown和KeyPress的区别是KeyDown传送被按下的键的键盘码，而KeyPress传送被按下键的char值。

KeyUp：当控件有焦点时，释放一个键时发生该事件，这个事件总是在KeyDown和KeyPress之后引发。

GotFocus：在控件接收焦点时引发。不要用这个事件执行控件的有效性验证，而应使用Validating和Validated。

LostFocus：在控件丢失焦点时引发。不要用这个事件执行控件的有效性验证，而应使用Validating和Validated。

MouseDown：在鼠标指针指向一个控件，且鼠标按钮被按下时引发。这与Click事件不同，因为在按钮被按下之后，且未被释放之前引发MouseDown。

MouseMove：在鼠标划过控件时引发。

MouseUp：在鼠标指针位于控件上，且鼠标按钮被释放时引发。

Paint：绘制控件时引发。

Validated：当控件的CausesValidation属性设置为true，且该控件获得焦点时，引发该事件。它在Validating事件之后发生，表示有效性验证已经完成。

Validating：当控件的CausesValidation属性设置为true，且该控件获得焦点时，引发该事件。需要注意的是，被验证有效性的控件是失去焦点的控件，而不是获得焦点的控件。

待续.................................