免使用由經(jīng)常使用的名稱空間復(fù)制的類型名。類型名不能使用下列詞語。

System       Collections   Forms       UI



避免使用與常用關(guān)鍵詞沖突的標(biāo)識符。例如，避免使用下列詞語。

AddHandler

AddressOf

Alias

And

Ansi

As

Assembly

Auto

BitAnd

BitNot

BitOr

BitXor

Boolean

ByRef

Byte

ByVal

Call

Case

Catch

CBool

CByte

CChar

CDate

CDec

CDbl

Char

CInt

Class

CLng

CObj

Const

CShort

CSng

CStr

CType

Date

Decimal

Declare

Default

Delegate

Dim

Do

Double

Each

Else

ElseIf

End

Enum

Erase

Error

Event

Exit

ExternalSource

False

Finally

For

Friend

Function

Get

GetType

Goto

Handles

If

Implements

Imports

In

Inherits

Integer

Interface

Is

Let

Lib

Like

Long

Loop

Me

Mod

Module

MustInherit

MustOverride

MyBase

MyClass

Namespace

New

Next

Not

Nothing

NotInheritable

NotOverridable

Object

On

Option

Optional

Or

Overloads

Overridable

Overrides

ParamArray

Preserve

Private

Property

Protected

Public

RaiseEvent

ReadOnly

ReDim

Region

REM

RemoveHandler

Resume

Return

Select

Set

Shadows

Shared

Short

Single

Static

Step

Stop

String

Structure

Sub

SyncLock

Then

Throw

To

True

Try

TypeOf

Unicode

Until

Variant

When

While

With

WithEvents

WriteOnly

Xor

eval

extends

instanceof

package

var





標(biāo)識符（包括參數(shù)名）中不要使用縮寫。

如果必須使用縮寫：

任何超過兩個字符以上的縮寫都使用camel大寫格式，即使這不是標(biāo)準(zhǔn)縮寫。



名稱空間

命名名稱空間的一般規(guī)則如下：

CompanyName.TechnologyName



這樣，我們看到的名稱空間應(yīng)該是這樣的：

Microsoft.Office

PowerSoft.PowerBuilder



注意：這只是一個原則。第三方公司可以選擇其它的名字。



避免用公司名稱或其它著名品牌的名稱作為名稱空間的前綴，這樣會造成兩個公布的名稱空間有同一個名稱的可能性。（例如，將微軟提供的Office自動類命名為Microsoft.Office。）



使用Pascal大寫方式，用逗號分隔邏輯成分（例如，Microsoft.Office.PowerPoint）。如果你的品牌使用的是非傳統(tǒng)大寫方式，那么一定要遵循你的品牌所確定使用的大寫方式，即使這種方式背離了通常的名稱空間大寫規(guī)則（例如，NeXT.WebObjects，和ee.cummings。）



該用復(fù)數(shù)的時候要使用復(fù)數(shù)的名稱空間名。例如，使用System.Collections而不是System.Collection。本規(guī)則的特例是品牌名稱和縮寫。例如：使用System.IO而不是System.IOs。



名稱空間和類不能使用同樣的名字。例如，有一個類被命名為Debug后，就不要再使用Debug作為一個名稱空間名。



類和類成分



類的命名原則

用名詞或名詞短語命名類。

使用Pascal大寫。

減少類名中縮寫的使用量。

不要使用任何類前綴（比如C）。

不要使用帶下劃線的字符。



下面是一些正確命名的類名的例子。

public class FileStream {

}

public class Button {



}

public class String {

}



接口命名原則

使用名詞或名詞短語，或者描述行為的形容詞來命名接口。例如，IComponent（描述性名詞），ICustomAttributeProvider（名詞短語），和IPersistable（形容詞）。

使用Pascal大寫。

減少接口名中縮寫的使用量。

不要使用帶下劃線的字符。

在接口名前加前綴I，以表示這個類型是一個接口。

不要在類名前加上前綴C。偶而情況下，需要在類名前加上I而并不表示它是一個接口。在這種情況下，只要I后面的字符是小寫就可（例如，IdentityStore。）

當(dāng)類是接口的標(biāo)準(zhǔn)執(zhí)行時，定義這一對類/接口組合就要使用相似的名稱。兩個名稱的不同之處只是接口名前有一個I前綴。



下面我們舉個例子，來看看接口IComponent和它的標(biāo)準(zhǔn)執(zhí)行，類Component。

public interface IComponent {

}

public class Component : IComponent {

}

public interface IServiceProvider{

}

public interface IFormatable {

}



屬性命名原則



在屬性的后面加上Attribute后綴，來自定義屬性類。如下例所示。

public class ObsoleteAttribute{

}



Enum命名原則

Enum需使用Pascal大寫。

Enum值名需使用Pascal大寫。

減少enum名中縮寫的使用量。

Enum名前不要加前綴（例如，adxxx表示ADO enums，rtfxxx表示多信息文本enum，等等。）。

在enum類型上不要加Enum后綴。

Enum名稱需使用單數(shù)名詞。

比特域使用復(fù)數(shù)名詞。

如果列舉值在參數(shù)或?qū)傩灾惺褂�，需用一個enum來定義列舉值。這樣工具就可以知道一個屬性或參數(shù)可能的值了。



public enum FileMode{

Create,

CreateNew,

Open,

OpenOrCreate,

Truncate

}



如果數(shù)字值to be bitwise or'ed together，就使用Flags對屬性進(jìn)行自定義。



[Flags]

public enum Bindings {

CreateInstance,

DefaultBinding,

ExcatBinding,

GetField,

GetProperty,

IgnoreCase,

InvokeMethod,

NonPublic,

OABinding,

SetField

SetProperty,

Static

}



在封裝一個Win32 API時，這個規(guī)則有一個特例。從一個Win32標(biāo)頭產(chǎn)生內(nèi)部定義是很常見的。你可以使用Win32大寫，這種形式下字母通常全部大寫。



使用Int32作為一個enum的基礎(chǔ)類型。

如果這個enum代表標(biāo)志，而且標(biāo)志又非常多（大于32），或者這個enum在將來可以發(fā)展成許多標(biāo)志，或者類型需要與類型int有所不同以便向后兼容時，在這種情況下就產(chǎn)生了特例。



只有在值可以被完全表示為一組位標(biāo)志時，才使用enum。開集不能使用enum（例如操作系統(tǒng)版，等等）。



只讀和Const字段名

用名詞，名詞短語，或名詞的縮寫命名靜態(tài)字段。

用Pascal大寫命名靜態(tài)字段。

不要用匈牙利文類型的符號作靜態(tài)字段名的前綴。



參數(shù)名

使用描述性參數(shù)名。參數(shù)名應(yīng)該具有足夠的描述性，這樣在大多數(shù)情況下參數(shù)名和它的種類可以用來確定它的意思。

用camel大寫方式命名參數(shù)。

根據(jù)參數(shù)的意思來命名參數(shù)，而不是根據(jù)參數(shù)的種類來命名。我們希望開發(fā)工具可以用很方便的方式提供關(guān)于參數(shù)種類的信息，這樣參數(shù)名可以得到更好的使用，可以對語義而不是對種類進(jìn)行描述。但是偶爾使用根據(jù)類型命名的參數(shù)名也是完全可以的。



不要使用保留參數(shù)。如果在下一個版本中需要更多的數(shù)據(jù)，可以增加進(jìn)來。

不要用匈牙利文類型的符號作為字段名的前綴。



Type GetType (string typeName)

string Format (string format, object [] args)



方法命名原則

用動詞或動詞短語命名方法。

用下述范例所示的Pascal大寫方式命名方法。

RemoveAll()

GetCharArray()

Invoke()



屬性命名原則

用名詞或名詞短語命名屬性。

用Pascal大寫命名屬性。

屬性與類型要一樣。

用與一個類型的名稱相同的名字來命名屬性時，就使這個屬性的類型成為那個類型。雖然聽起來有些奇怪，但這是正確的。下面的例子正確使用了屬性命名原則。

public enum Color {...}

public class Control {

public Color Color { get {...} set {...} }

}

下例就是不正確的。

public enum Color {...}

public class Control {

public int Color { get {...} set {...} }

}



在那個不正確的例子中，要想引用Color enum是不可能的，因?yàn)镃olor,Xxx會被翻譯成一個成員訪問，它會首先獲得Color屬性的值（int種類），然后再訪問那個值的成員（它應(yīng)該是System.Int32的一個實(shí)例成員）。



事件命名原則

用EventHandloer后綴命名事件處理程序，如下列所示。

public delegate void MouseEventHandler(object sender, MouseEvent e);



使用名為sender和e的兩個參數(shù)。

Sender參數(shù)代表提出事件的對象。Sender參數(shù)永遠(yuǎn)是一個類型對象，即使它可能使用了更為特定的類型。



與事件相關(guān)的狀態(tài)被封裝在一個名為e的事件類范例中。要使用這個類型的正確的、特定的事件類。

public delegate void MouseEventHandler(object sender, MouseEvent e);



用EventArgs后綴命名事件自變量類，如下例所示。

public class MouseEventArgs : EventArgs {

int x;

int y;

public MouseEventArgs(int x, int y)

{ this.x = x; this.y = y; }

public int X { get { return x; } }

public int Y { get { return y; } }

}



命名事件名時，需要有之前和之后的時態(tài)概念，因此要使用現(xiàn)在時態(tài)和過去時態(tài)（不要使用BeforeXxx\AfterXxx的方式）。例如，可以被取消的結(jié)束事件就有Closing事件和Closed事件。



public event ControlEventHandler ControlAdded {

//..

}



用動詞命名事件。



區(qū)分大小寫

不要使用需要對大小寫作出區(qū)分的名稱。各成分不論是在區(qū)分大小寫還是不區(qū)分大小寫的語言下都必須是完全可用的。因?yàn)椴粎^(qū)分大小寫的語言不能在同樣的環(huán)境下對只有大小寫不同的兩個名稱作出辯別，所以成分必須避免這種情況。

不要產(chǎn)生兩個名稱相同只有大小寫不同的名稱空間。

namespace ee.cummings;

namespace Ee.Cummings;

帶有兩個參數(shù)的一個類型，其兩個參數(shù)的名稱不能只有大小寫不同。

void foo(string a, string A)

System.WinForms.Point p;

System.WinForms.POINT pp;

帶有兩個屬性的一個類型，其屬性的名稱不能只有大小寫不同。

int Foo {get, set};

int FOO {get, set}

帶有兩種方法的一個類型，其方法的名稱不能只有大小寫不同。

void foo();

void Foo();



避免類型名出現(xiàn)混淆



不同的語言使用不同的術(shù)語以識別基本管理類型。設(shè)計(jì)人員必須避免使用對語言有專門要求的術(shù)語。遵照本章說明的規(guī)則，避免出現(xiàn)類型名稱混淆的情況。

使用語義上有意義的名稱，而不要使用類型名稱。

在很少見的情況下，參數(shù)除了類型以外語義上沒有任何意義，這時使用類屬名。例如，一個類支持將多種數(shù)據(jù)類型寫進(jìn)一個流中，這個類可能有下列方法：

void Write(double value);

void Write(float value);

void Write(long value);

void Write(int value);

void Write(short value);

上面的例子在下述對語言有專門要求的情況下是首選。

void Write(double doubleValue);

void Write(float floatValue);



void Write(long longValue);

void Write(int intValue);

void Write(short shortValue);



在極端情況下，每一個基本數(shù)據(jù)類型需要有唯一的命名方式，此時使用下面的通用類型名稱。

C# type name

Visual Basic type name

JScript type name

Visual C++ type name

IL representation

Universal type name

sbyte

SByte

SByte

char

I1

SByte

byte

Byte

byte

unsigned char

U1

Byte

short

Short

short

short

I2

Int16

ushort

UInt16

UInt16

unsigned short

U2

UInt16

int

Integer

int

int

I4

Int32

uint

NA

NA

unsigned int

U4

UInt32

long

Long

long

__int64

I8

Int64

ulong

UInt64

UInt64

Unsigned __int64

U8

UInt64

float

Single

float

float

R4

Single

double

Double

double

double

R8

Double

bool

Boolean

boolean

bool

I4

Boolean

char

Char

char

wchar_t

U2

Char

string

String

String

String

System.String

String

object

Object

Object

Object

System.Object

Object



一個支持從流中讀取多種數(shù)據(jù)類型的類可以有下列方法。

double ReadDouble();

float ReadSingle();

long ReadIn64();

int ReadInt32();

short ReadInt16();



上面的例子在下述對語言有專門要求的情況下是首選。

double ReadDouble();

float ReadFloat();

long ReadLong();

int ReadInt();

short ReadShort();