ASPNET命名规范.doc
ASPNET命名规范.doc
- 配套讲稿：
如PPT文件的首页显示word图标，表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制：
部分文档作品中含有的国旗、国徽等图片，仅作为作品整体效果示例展示，禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词：
- ASPNET 命名 规范
- 资源描述：
-
A 命名规范 VS.NET 2003 控件命名规范 1.变量命名规范 类型 前缀 示例 Array arr arrShoppingList Boolean bln blnIsPostBack Byte byt bytPixelValue Char chr chrDelimiter DateTime dtm dtmStartDate Decimal dec decAverageHeight Double dbl dblSizeofUniverse Integer int intRowCounter Long lng lngBillGatesIncome Object obj objReturnValue Short shr shrAverage Single sng sngMaximum String str strFirstName 2.控件命名规范 类型 前缀 示例 AdRotator adrt adrtTopAd Button btn btnSubmit Calendar cal calMettingDates CheckBox chk chkBlue CheckBoxList chkl chklFavColors CompareValidator valc valcValidAge CustomValidator valx valxDBCheck DataGrid dgrd dgrdTitles DataList dlst dlstTitles DropDownList drop dropCountries HyperLink lnk lnkDetails Image img imgAuntBetty ImageButton ibtn ibtnSubmit Label lbl lblResults LinkButton lbtn lbtnSubmit ListBox lst lstCountries Panel pnl pnlForm2 PlaceHolder plh plhFormContents RadioButton rad radFemale RadioButtonList radl radlGender RangeValidator valg valgAge RegularExpression vale valeEmail_Validator Repeater rpt rptQueryResults RequiredFieldValidator valr valrFirstName Table tbl tblCountryCodes TableCell tblc tblcGermany TableRow tblr tblrCountry TextBox txt txtFirstName ValidationSummary vals valsFormErrors XML xmlc xmlcTransformResults 3.ADO.NET控件命名规范 类型 前缀 示例 Connection con conNorthwind Command cmd cmdReturnProducts Parameter parm parmProductID DataAdapter dad dadProducts DataReader dtr dtrProducts DataSet dst dstNorthWind DataTable dtbl dtblProduct DataRow drow drowRow98 DataColumn dcol dcolProductID DataRelation drel drelMasterDetail DataView dvw dvwFilteredProducts 4.事件处理子程序 The name of an event-handling subroutine will consist of the ID of the control that rasied the event followed by the type of event being handled. For example, a subroutine named btnSubmit_Click handles the Click event of a Button control named btnSubmit. When a control that raises an event is not assigned an ID, the type of the control is used instead of the ID. For example, the subroutine named Button_Click handles the Click event of a Button control without an ID. VS.NET 控件命名规范 Type Prefix Example Array arr arrShoppingList Boolean bln blnIsPostBack Byte byt bytPixelValue Char chr chrDelimiter DateTime dtm dtmStartDate Decimal dec decAverageHeight Double dbl dblSizeofUniverse Integer int intRowCounter Long lng lngBillGatesIncome Object obj objReturnValue Short shr shrAverage Single sng sngMaximum String str strFirstName WebControls Type Prefix Example AdRotator adrt adrtTopAd Button btn btnSubmit Calendar cal calMettingDates CheckBox chk chkBlue CheckBoxList chkl chklFavColors CompareValidator valc valcValidAge CustomValidator valx valxDBCheck DataGrid dgrd dgrdTitles DataList dlst dlstTitles DropDownList drop dropCountries HyperLink lnk lnkDetails Image img imgAuntBetty ImageButton ibtn ibtnSubmit Label lbl lblResults LinkButton lbtn lbtnSubmit ListBox lst lstCountries Panel pnl pnlForm2 PlaceHolder plh plhFormContents RadioButton rad radFemale RadioButtonList radl radlGender RangeValidator valg valgAge RegularExpression vale valeEmail_Validator Repeater rpt rptQueryResults RequiredFieldValidator valr valrFirstName Table tbl tblCountryCodes TableCell tblc tblcGermany TableRow tblr tblrCountry TextBox txt txtFirstName ValidationSummary vals valsFormErrors XML xmlc xmlcTransformResults ADO.NET Type Prefix Example Connection con conNorthwind Command cmd cmdReturnProducts Parameter parm parmProductID DataAdapter dad dadProducts DataReader dtr dtrProducts DataSet dst dstNorthWind DataTable dtbl dtblProduct DataRow drow drowRow98 DataColumn dcol dcolProductID DataRelation drel drelMasterDetail DataView dvw dvwFilteredProducts .NET命名规范中文版 避免使用由经常使用的名称空间复制的类型名。类型名不能使用下列词语。 System Collections Forms UI 避免使用与常用关键词冲突的标识符。例如，避免使用下列词语。 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 标识符（包括参数名）中不要使用缩写。 如果必须使用缩写： 任何超过两个字符以上的缩写都使用camel大写格式，即使这不是标准缩写。 名称空间 命名名称空间的一般规则如下： CompanyName.TechnologyName 这样，我们看到的名称空间应该是这样的： Microsoft.Office PowerSoft.PowerBuilder 注意：这只是一个原则。第三方公司可以选择其它的名字。 避免用公司名称或其它著名品牌的名称作为名称空间的前缀，这样会造成两个公布的名称空间有同一个名称的可能性。（例如，将微软提供的Office自动类命名为Microsoft.Office。） 使用Pascal大写方式，用逗号分隔逻辑成分（例如，Microsoft.Office.PowerPoint）。如果你的品牌使用的是非传统大写方式，那么一定要遵循你的品牌所确定使用的大写方式，即使这种方式背离了通常的名称空间大写规则（例如，NeXT.WebObjects，和ee.cummings。） 该用复数的时候要使用复数的名称空间名。例如，使用System.Collections而不是System.Collection。本规则的特例是品牌名称和缩写。例如：使用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。） 当类是接口的标准执行时，定义这一对类/接口组合就要使用相似的名称。两个名称的不同之处只是接口名前有一个I前缀。 下面我们举个例子，来看看接口IComponent和它的标准执行，类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名称需使用单数名词。 比特域使用复数名词。 中国3S吧 如果列举值在参数或属性中使用，需用一个enum来定义列举值。这样工具就可以知道一个属性或参数可能的值了。 public enum FileMode{ Create, CreateNew, Open, OpenOrCreate, Truncate } 如果数字值to be bitwise or'ed together，就使用Flags对属性进行自定义。 [Flags] public enum Bindings { CreateInstance, DefaultBinding, ExcatBinding, GetField, GetProperty, IgnoreCase, InvokeMethod, NonPublic, OABinding, SetField SetProperty, Static } 在封装一个Win32 API时，这个规则有一个特例。从一个Win32标头产生内部定义是很常见的。你可以使用Win32大写，这种形式下字母通常全部大写。 使用Int32作为一个enum的基础类型。 如果这个enum代表标志，而且标志又非常多（大于32），或者这个enum在将来可以发展成许多标志，或者类型需要与类型int有所不同以便向后兼容时，在这种情况下就产生了特例。 只有在值可以被完全表示为一组位标志时，才使用enum。开集不能使用enum（例如操作系统版，等等）。 只读和Const字段名 用名词，名词短语，或名词的缩写命名静态字段。 用Pascal大写命名静态字段。 不要用匈牙利文类型的符号作静态字段名的前缀。 参数名 使用描述性参数名。参数名应该具有足够的描述性，这样在大多数情况下参数名和它的种类可以用来确定它的意思。 用camel大写方式命名参数。 根据参数的意思来命名参数，而不是根据参数的种类来命名。我们希望开发工具可以用很方便的方式提供关于参数种类的信息，这样参数名可以得到更好的使用，可以对语义而不是对种类进行描述。但是偶尔使用根据类型命名的参数名也是完全可以的。 不要使用保留参数。如果在下一个版本中需要更多的数据，可以增加进来。 不要用匈牙利文类型的符号作为字段名的前缀。 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 {...} } 中国3S吧 } 在那个不正确的例子中，要想引用Color enum是不可能的，因为Color,Xxx会被翻译成一个成员访问，它会首先获得Color属性的值（int种类），然后再访问那个值的成员（它应该是System.Int32的一个实例成员）。 事件命名原则 用EventHandloer后缀命名事件处理程序，如下列所示。 public delegate void MouseEventHandler(object sender, MouseEvent e); 使用名为sender和e的两个参数。 Sender参数代表提出事件的对象。Sender参数永远是一个类型对象，即使它可能使用了更为特定的类型。 与事件相关的状态被封装在一个名为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; } } } 命名事件名时，需要有之前和之后的时态概念，因此要使用现在时态和过去时态（不要使用BeforeXxx\AfterXxx的方式）。例如，可以被取消的结束事件就有Closing事件和Closed事件。 中国3S吧 public event ControlEventHandler ControlAdded { //.. } 用动词命名事件。 区分大小写 不要使用需要对大小写作出区分的名称。各成分不论是在区分大小写还是不区分大小写的语言下都必须是完全可用的。因为不区分大小写的语言不能在同样的环境下对只有大小写不同的两个名称作出辩别，所以成分必须避免这种情况。 不要产生两个名称相同只有大小写不同的名称空间。 namespace ee.cummings; namespace Ee.Cummings; 带有两个参数的一个类型，其两个参数的名称不能只有大小写不同。 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(); 避免类型名出现混淆 不同的语言使用不同的术语以识别基本管理类型。设计人员必须避免使用对语言有专门要求的术语。遵照本章说明的规则，避免出现类型名称混淆的情况。 使用语义上有意义的名称，而不要使用类型名称。 在很少见的情况下，参数除了类型以外语义上没有任何意义，这时使用类属名。例如，一个类支持将多种数据类型写进一个流中，这个类可能有下列方法： 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); 在极端情况下，每一个基本数据类型需要有唯一的命名方式，此时使用下面的通用类型名称。 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 一个支持从流中读取多种数据类型的类可以有下列方法。 double ReadDouble(); float ReadSingle(); long ReadIn64(); int ReadInt32(); short ReadInt16(); 上面的例子在下述对语言有专门要求的情况下是首选。 double ReadDouble(); float ReadFloat(); long ReadLong(); int ReadInt(); short ReadShort();展开阅读全文
咨信网温馨提示：1、咨信平台为文档C2C交易模式，即用户上传的文档直接被用户下载，收益归上传人（含作者）所有；本站仅是提供信息存储空间和展示预览，仅对用户上传内容的表现方式做保护处理，对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿，我们不确定上传用户享有完全著作权，根据《信息网络传播权保护条例》，如果侵犯了您的版权、权益或隐私，请联系我们，核实后会尽快下架及时删除，并可随时和客服了解处理情况，尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确)，网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据，个别因单元格分列造成显示页码不一将协商解决，平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺，下载前须认真查看，确认无误后再购买，务必慎重购买；若有违法违纪将进行移交司法处理，若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传，付费前请自行鉴别，如您付费，意味着您已接受本站规则且自行承担风险，本站不进行额外附加服务，虚拟产品一经售出概不退款（未进行购买下载可退充值款），文档一经付费（服务费）、不意味着购买了该文档的版权，仅供个人/单位学习、研究之用，不得用于商业用途，未经授权，严禁复制、发行、汇编、翻译或者网络传播等，侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印，是因预览和防盗链等技术需要对页面进行转换压缩成图而已，我们并不对上传的文档进行任何编辑或修改，文档下载后都不会有水印标识（原文档上传前个别存留的除外），下载后原文更清晰；试题试卷类文档，如果标题没有明确说明有答案则都视为没有答案，请知晓；PPT和DOC文档可被视为“模板”，允许上传人保留章节、目录结构的情况下删减部份的内容；PDF文档不管是原文档转换或图片扫描而得，本站不作要求视为允许，下载前可先查看【教您几个在下载文档中可以更好的避免被坑】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权，请谨慎使用；网站提供的党政主题相关内容(国旗、国徽、党徽－－等)目的在于配合国家政策宣传，仅限个人学习分享使用，禁止用于任何广告和商用目的。
6、文档遇到问题，请及时联系平台进行协调解决，联系【微信客服】、【QQ客服】，若有其他问题请点击或扫码反馈【服务填表】；文档侵犯商业秘密、侵犯著作权、侵犯人身权等，请点击“【版权申诉】”，意见反馈和侵权处理邮箱：1219186828@qq.com；也可以拔打客服电话：0574-28810668；投诉电话：18658249818。
实名认证
平台协调中心【客服】
自信AI助手
微信客服
客服QQ
发送邮件
意见反馈
链接地址：https://www.zixin.com.cn/doc/12004570.html