浅析.NET开发过程中命名的数量和人称

我们都明白命名的重要性,如果对命名不断地关注,就需要考虑命名中的动词和名词,特别的情况是动词的人称和名词的数量。

10余年的仲巴网站建设经验,针对设计、前端、开发、售后、文案、推广等六对一服务,响应快,48小时及时工作处理。营销型网站建设的优势是能够根据用户设备显示端的尺寸不同,自动调整仲巴建站的显示方式,使网站能够适用不同显示终端,在浏览器中调整网站的宽度,无论在任何一种浏览器上浏览网站,都能展现优雅布局与设计,从而大程度地提升浏览体验。成都创新互联从事“仲巴网站设计”,“仲巴网站推广”以来,每个客户项目都认真落实执行。

在.NET Framework的Guideline中,有专门一章讨论了命名规范,包括大小写、单词的选择等,却没有涉及到人称和数量,下面来讨论一下这两方面的内容。

名词的数量

首先来看数量。名词的单数和复数在语义上有着明显的不同,为了提高可读性,数量需要认真地考虑。比如:

属性(Property):System.Collections.Generic.Dictionary中的Keys和Count是好的例子。字段与此类似; 方法名中的名词:在JS中我们熟悉的getElementById和getElementsByTagName;

局部变量:与属性相比,我们更可能遭遇的是局部变量。比如,用变量来表示一个人的名字,可以用string name; 如果是多个人的名字,则可以用List names。

一般地,单数表达的语义是?(0或1);复数表达的语义是*(0、1或多个)。关于名词的数量很容易理解,相关的规则也容易遵循。

动词的人称

下面再来考虑动词的人称。在需要考虑命名的对象中,包括命名空间、类型、各种类型成员,只有方法是动词,语义上表示一个行为。关于它的人称,来看一个.NET Framework中的例子。在System.Collections.Generic.Stack中,有一个Contains(T item)方法,对于这样的代码:

 
 
 
  1. if (theStack.Contains(1))   
  2.  {   
  3.     // Do something.   
  4.  } 

读起来像是:if the stack contains 1,比较通顺。是不是所有方法都要这样命名呢?没有。另两个方法Clear()和Push(T item)就不是如此,这个地方很让人困惑。先写成代码看看

 
 
 
  1. theStack.Push(3);   
  2. theStack.Clear(); 

尝试像上面那样作为一个句子来读:the stack push 3; the stack clear,语法上不对,看起来也应该是第三人称。这里我也不确定为何如此,只能尝试来解释下。考察多个集合类型和其它类型后发现,所有使用第三人称的地方都是谓词函数,除了上面的Contains(T item),还有Directory.Exists(string path),不知道这是不是其中的命名规则呢?

还要考虑注释

一定程度上,注释也算是一种代码。一种是XML文档注释,在.NET Framework中,不管是对于类型还是类型成员,都使用了第三人称,这一点我们也可以遵循。其它的普通注释应该也可以遵循这个规则。

原文链接:http://www.cnblogs.com/anderslly/archive/2011/01/26/name-conventions.html

【编辑推荐】

  1. .NET Framework字符串相关操作细节介绍
  2. 详解.NET字符串解析的具体过程
  3. 改进C#连接字符串的性能
  4. .NET Lambda表达式的语义:字符串列表范例
  5. C#字符串的几种常用方法

当前题目:浅析.NET开发过程中命名的数量和人称
文章分享:http://www.shufengxianlan.com/qtweb/news12/88162.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联