StyleCop常用规则及问题.docxVIP

StyleCop（Microsoft Source Analysis for C#）常用规则及问题寄菜鸟对于像我这样还是菜鸟级的程序员来说，Leader分配给我的任务，只要按时做完就OK,哪有时间去理代码的优雅，可读性！就算有，就咱这个水平，。。。！别人看不懂管他呢！只要我看得懂不就行了！由于平时没有注重，老大让我去维护自己以前做过的项目，结果完全傻眼了，咋一点印象都没有了呢！这不可能是我做的吧！代码混乱不堪，定义的语句只能去猜它的本意，明明只要修改一个小地方，却要从头到尾去了解整个程序，耽误时间！回想起当初写代码时为了追求能尽早的完成任务，忽略了代码的规范性，现在真是追悔莫及！所以决定从现在开始养成一个良好的编码风格，虽然编码的速度会有所降低，但是从长远出发，是很值得的！但是自己水平有限，有没有类似功能的工具呢！功夫不负有心人，它就是StyleCop.体会刚开始时，说实话感觉这个家伙有点变态，普通的一个程序，就几十个警告！而且有些不太理解！如果觉得自己这样做有充分的理由，也不必遵循StyleCop的规则。下面开始介绍StyleCop的一些我常常违反的一些规则。常用规则基础namespace names begin with an upper-case letter:.解释：命名空间的名称必须以大写字母开头Invalid spacing around the comma.解释：逗号后面需要加空格(几个无所谓)Adjacent elements must be separated by a blank line.解释：紧邻的元素之间必须用空格行隔开，例如using命名空间和namespace之间。Using directives must be sorted alphabetically by the namespaces.解释：using语句必须要按照字母排序(顺序)The code must not contain multiple blank lines in a row.解释：代码中不允许一行中有多行空行。文档规范：All using directives must be placed inside of the namespace.解释：所有using指令必需放到命名空间内。这样使用的好处：/b/abhinaba/archive/2006/08/21/709051.aspx1.Lowers the chances of namespace pollution in case the source file has more than one namespace declaration in it2.Reduces the size of the drop down in intellisense 3.Conflict detection in aliasingThe class must have a documentation header.解释：定义的类必须含有文件头标志’///’而且其中的内容介绍最好是带有空格的(有点变态)，不然可能会报’ The documentation text within the summary tag does not contain any whitespace between words, indicating that it most likely does not follow a proper grammatical structure required for documentation text’The file has no header, the header Xml is invalid, or the header is not located at the top of the file.解释：需要在文件开头上加：//-------------------------------------------------------// copyright file=Person.cs company=MyCompany// Copyright MyCompany. All rights reserved.// /copyright//-------------------------------------------------------类规范The class must have an access modifier.解释：类必须有访问修饰符The class must have a documentation header.解释：类必须要有文档说明，就是以“///”开头class names begin with an upper-case letter: