代码审查工具FxCop建议采用的规则总结
续接:
代码走查工具篇FxCop的规则总结与翻译_Part1
代码走查工具篇FxCop的规则总结与翻译_Part2
代码走查工具篇FxCop的规则总结与翻译_Part3
本篇结合我的实际工作需要,总结了一份在实际工作中采纳的规则项目,总结不妥之处,还请多海涵。
1、AbstractTypesShouldNotHaveConstructors CA1012
不言而喻,抽象类型里即使编写了构造函数也不能直接的调用到。
4、AvoidExcessiveParametersOnGenericTypes CA1005
避免泛型类型的参数过多,两个是一个分界线,最好不要超过两个。
7、CollectionsShouldImplementGenericInterface CA1010
集合应该实现泛型接口,常见的泛型接口为: System.Collections.Generic.IEnumerable<T>
System.Collections.Generic.ICollection<T>
System.Collections.Generic.IList<T>
8、ConsiderPassingBaseTypesAsParameters CA1011
某方法声明包含一个派生类型的形参,且该方法仅调用该参数的基类型的成员的时候参数要定义成基类型,这样这个方法使用面会更广,任何这个基类的子类都可以当做实参传进来。
9、DeclareEventHandlersCorrectly CA1009
正确声明事件处理程序,举一个自己写的小例子:
using System;
using System.Windows.Forms;
namespace TestFxCopRule
{
public class AlarmEventArgs : EventArgs {
public AlarmEventArgs(string myName, int myAge) {
this.MyName = myName;
this.MyAge = myAge;
}
private AlarmEventArgs()
{}
public string MyName;
public int MyAge;
}
public delegate void AlarmEventHandler(object sender, AlarmEventArgs e);
public class MyEvent
{
public AlarmEventHandler DDD;
public MyEvent()
{
DDD+= dd;
}
public void InvokeMyEvent()
{
if(DDD==null)
{
return;
}
AlarmEventArgs e=new AlarmEventArgs("Anders lu",28);
DDD(this,e);
}
public void dd (object sender, AlarmEventArgs e)
{
MyEvent mye=sender as MyEvent;
MessageBox.Show(e.MyName+" Invoke MyEvent in "+ mye.GetType().ToString() );
}
}
}
10、DeclareTypesInNamespaces CA1050
应在命名空间内声明类型以避免名称冲突,并作为一种在对象层次结构中组织相关类型的方式。位于任何命名的命名空间之外的类型属于全局命名空间,全局命名空间无法在代码中引用。
11、DefaultParametersShouldNotBeUsed CA1026
为了使.net代码应用面更广,建议不要使用默认参数,如果有这方便的需求可以采取提供默认参数的方法重载来替换使用默认参数的方法
12、DoNotDeclareProtectedMembersInSealedTypes CA1047
不要在密封类型中声明受保护的成员,按照定义,不能从密封类型继承,意味着不能调用密封类型上受保护的方法。
16、DoNotDeclareVirtualMembersInSealedTypes CA1048
不要在密封类型中声明虚拟成员,类型将方法声明为虚方法,使继承类型可以重写虚方法的实现。根据定义,不能从密封类型继承,这使得密封类型上的虚方法没有意义。
17、DoNotDeclareVisibleInstanceFields CA1051
不要声明可见实例字段,字段的主要用途应是作为实现的详细信息。字段应为 private 或 internal,并应当通过使用属性来公开。访问属性和访问字段一样容易,且随着类型的功能扩展,无需引入间断更改即可更改属性的访问器中的代码。仅返回私有或内部字段值的属性经过优化,可以像访问字段那样执行;在属性上使用外部可见字段不太会提高性能。
18、DoNotExposeGenericLists CA1002
不要公开泛型列表,System.Collections.Generic.List<T> 是针对性能(而非继承)设计的泛型集合。 System.Collections.Generic.List<T> 不包含更便于更改继承类的行为的虚拟成员。下面的泛型集合是针对继承功能设计的,应公开为 System.Collections.Generic.List<T> 以外的内容。
System.Collections.ObjectModel.Collection<T>
System.Collections.ObjectModel.ReadOnlyCollection<T>
System.Collections.ObjectModel.KeyedCollection<TKey, TItem>
19、DoNotHideBaseClassMethods CA1061
不要隐藏基类方法,如果派生方法的参数签名只是在类型方面有所不同,而且与基方法的参数签名中的对应类型相比,这些类型的派生方式更弱,则基类型中的方法将被派生类型中的同名方法隐藏。
21、DoNotOverloadOperatorEqualsOnReferenceTypes CA1046
不要对引用类型重载相等运算符,对于引用类型,相等运算符的默认实现几乎始终是正确的。默认情况下,仅当两个引用指向同一对象时,它们才相等。
23、DoNotRaiseExceptionsInUnexpectedLocations CA1065
不要在意外的位置引发异常,不应引发异常的方法可分为以下几类:
Property Get 方法;事件访问器方法;Equals 方法;GetHashCode 方法;ToString 方法;静态构造函数;终结器;Dispose 方法;相等运算符;隐式转换运算符。
24、EnumStorageShouldBeInt32 CA1028
枚举存储应为 Int32,使用示例如下:
[Flags]
public enum Days : int
{
None = 0,
Monday = 1,
Tuesday = 2,
Wednesday = 4,
Thursday = 8,
Friday = 16,
All = Monday| Tuesday | Wednesday | Thursday | Friday
}
EnumeratorsShouldBeStronglyTyped CA1038
枚举数应强类型化,此规则要求 IEnumerator 实现还提供 Current 属性的强类型版本,以使用户在使用该接口提供的功能时不必将返回值强制转换为强类型。该规则假定实现 IEnumerator 的类型包含强于 Object 的类型的实例集合。
25、EnumsShouldHaveZeroValue CA1008
枚举后选址里必须包含零值,像其他值类型一样,未初始化枚举的默认值为零。无标志特性的枚举应定义值为零的成员,这样默认值即为该枚举的有效值。如果合适,将该成员命名为“None”。否则,将零赋给最常用的成员。请注意,默认情况下,如果声明中未设置第一个枚举成员的值,则其值为零。
如果应用了 FlagsAttribute 的枚举定义零值成员,则其名称应为“None”,以指示枚举中尚未设置值。出于任何其他目的使用零值成员都与使用 FlagsAttribute 的目的相背,因为 AND 和 OR 按位运算符对该成员无用。这意味着,只能为一个成员赋值零。请注意,如果应用了标志特性的枚举中发生多个零值的成员,则 Enum.ToString() 会为非零成员返回不正确结果。
26、ExceptionsShouldBePublic CA1064
异常应该是公共的,内部异常仅在其自己的内部范围内可见。当异常超出内部范围后,只能使用基异常来捕获该异常。如果内部异常是从 Exception、SystemException 或 ApplicationException继承的,外部代码将没有足够的信息了解如何处理该异常。
27、GenericMethodsShouldProvideTypeParameter CA1004
泛型方法应提供类型参数,下面的示例演示了调用两个泛型方法的语法。 InferredTypeArgument 的类型参数是推断出来的,而 NotInferredTypeArgument 的类型参数则必须是显式指定的。
using System;
namespace DesignLibrary
{
public class Inference
{
// This method violates the rule.
public void NotInferredTypeArgument<T>()
{
Console.WriteLine(typeof(T));
}
// This method satisfies the rule.
public void InferredTypeArgument<T>(T sameAsTypeParameter)
{
Console.WriteLine(sameAsTypeParameter);
}
}
class Test
{
static void Main()
{
Inference infer = new Inference();
infer.NotInferredTypeArgument<int>();
infer.InferredTypeArgument(3);
}
}
}
28、ICollectionImplementationsHaveStronglyTypedMembers CA1035
ICollection 实现含有强类型成员,此规则要求 ICollection 实现提供强类型成员,以使用户在使用该接口提供的功能时不必将参数强制转换成 Object 类型。该规则假定实现 ICollection 的类型执行此操作来管理强于 Object 的类型的实例集合。
ICollection 实现 System.Collections.IEnumerable 接口。如果集合中的对象扩展了 System.ValueType,则您必须为 GetEnumerator 提供一个强类型成员,以避免由装箱造成的性能下降。当集合的对象是引用类型时,这是不需要的。
要实现接口成员的强类型版本,请使用 InterfaceName.InterfaceMemberName 形式的名称(如 CopyTo)来显式实现接口成员。这些显式接口成员使用由该接口声明的数据类型。使用接口成员名称(如 CopyTo)来实现强类型成员。将强类型成员声明为公共的,将参数和返回值声明为由集合管理的强类型。这些强类型会替换由接口声明的较弱类型,例如 Object 和 Array。
29、ImplementIDisposableCorrectly CA1063
正确实现 IDisposable。
30、ImplementStandardExceptionConstructors CA1032
实现标准异常构造函数,异常类型必须实现下列构造函数:
公共 NewException()
公共 NewException(string)
公共 NewException(string, Exception)
受保护或私有的 NewException(SerializationInfo, StreamingContext)
如果不能提供完整的构造函数集,要正确处理异常将变得比较困难。例如,带有签名 NewException(string, Exception) 的构造函数用于创建由其他异常导致的异常。如果没有此构造函数,则无法创建和引发包含内部(嵌套)异常的自定义异常的实例,而在此类情况下托管代码应执行此操作。按照约定,前三个异常构造函数是公共的。第四个构造函数在未密封类中是受保护的,而在密封类中是私有的。
31、IndexersShouldNotBeMultidimensional CA1023
索引器不应是多维的,索引器(即索引属性)应该使用一个索引。多维索引器会大大降低库的可用性。如果设计需要使用多个索引,请重新考虑类型是否代表逻辑数据存储。否则,请使用方法。
32、InterfaceMethodsShouldBeCallableByChildTypes CA1033
接口方法应可由子类型调用,请考虑显式实现公共接口方法的基类型。从该基类型派生的类型只能通过对被强制转换为接口的当前实例(C# 中的 this)的引用来访问继承的接口方法。如果派生的类型重新实现(显式)继承的接口方法,则无法再访问基实现。通过当前实例引用进行的调用将调用派生的实现;这会导致递归调用,并最终导致堆栈溢出。
33、ListsAreStronglyTyped CA1039
列表提供强类型成员,此规则要求 IList 实现提供强类型成员,以使用户在使用该接口提供的功能时不必将参数强制转换成 System.Object 类型。 IList 接口由可以通过索引访问的对象集合实现。该规则假定实现 IList 的类型这样做以管理类型比 Object 更强的实例的集合。
39、MembersShouldNotExposeCertainConcreteTypes CA1059
成员不应公开某些具体类型
42、OverloadOperatorEqualsOnOverloadingAddAndSubtract CA1013
重载加法方法和减法方法时重载相等运算符。
43、OverrideMethodsOnComparableTypes CA1036
重写可比较类型中的方法,定义自定义排序顺序的类型实现 IComparable 接口。 CompareTo 方法返回一个整数值,指示该类型的两个实例的正确排序顺序。 该值标识设置排序顺序的类型;这意味着不会应用相等、不等、小于或大于的常规含义。 提供 IComparable 的实现时,通常还必须重写 Equals,以使其返回与 CompareTo 一致的值。 如果重写 Equals 并使用支持运算符重载的语言编写代码,则还应提供与 Equals 一致的运算符。
44、PropertiesShouldNotBeWriteOnly CA1044
get 访问器提供对属性的读访问,而 set 访问器提供写访问。 虽然可以接受且经常需要使用只读属性,但设计准则禁止使用只写属性。 这是因为允许用户设置值但又禁止该用户查看这个值不能提供任何安全性。 而且,如果没有读访问,将无法查看共享对象的状态,使其用处受到限制。
45、ProvideObsoleteAttributeMessage CA1041
提供 ObsoleteAttribute 消息,ObsoleteAttribute 用于标记被否决的库类型和成员。 库使用者应避免使用任何标记为已过时的类型或成员。 这是因为它可能不被支持,并将最终将从库的更高版本中被删除。 当编译用 ObsoleteAttribute 标记的类型或成员时,将显示特性的 Message 属性。 这将为用户提供有关已过时的类型或成员的信息。 该信息通常包括库设计器还将支持已过时类型或成员的时间长度,以及首选的替代类型或成员。
使用示例代码:
[Obsolete("Don't use Old CalcUtil1, use New CalcUtil2", true)]
46、ReplaceRepetitiveArgumentsWithParamsArray CA1025
用形参数组替换重复的实参,公共类型中的某个公共或受保护方法具有三个以上的参数,且其后三个参数为相同类型。
47、StaticHolderTypesShouldBeSealed CA1052
该规则假定只包含静态成员的类型没有设计为能被继承,因为该类型不提供可以在派生类型中重写的任何功能。 不希望被继承的类型应使用 sealed 修饰符禁止将其用作基类型。
48、StringUriOverloadsCallSystemUriOverloads CA1057
字符串 URI 重载调用 System.Uri 重载。
49、TypesShouldNotExtendCertainBaseTypes CA1058
类型不应扩展某些基类型,外部可见的类型扩展某些基类型。 目前,此规则报告从下列类型派生的类型:
System.ApplicationException
System.Xml.XmlDocument
System.Collections.CollectionBase
System.Collections.DictionaryBase
System.Collections.Queue
System.Collections.ReadOnlyCollectionBase
System.Collections.SortedList
System.Collections.Stack
52、UriParametersShouldNotBeStrings CA1054
URI 参数不应为字符串,
53、UriPropertiesShouldNotBeStrings CA1056
URI属性不应为字符串
54、UriReturnValuesShouldNotBeStrings CA1055
URI返回值不应为字符串
57、UseGenericsWhereAppropriate CA1007
在适当时机使用泛型。引用参数是用 ref(在 Visual Basic 中为 ByRef)关键字修饰的参数。为引用参数提供的参数类型必须与引用参数类型完全匹配。若要使用从引用参数类型派生的类型,必须首先对该类型进行强制转换,然后将该类型分配给引用参数类型的变量。使用泛型方法使受约束的所有类型都可以传递给方法,而无需先将类型强制转换为引用参数类型。
58、UseIntegralOrStringArgumentForIndexers CA1043
将整型或字符串参数用于索引器? 索引器(即索引属性),应将整型或字符串类型用于索引。这些类型一般用于为数据结构创建索引和提高库的可用性。Object 类型的使用应仅限于不能在设计时指定特定整型或字符串类型的那些情况。如果设计需要对索引使用其他类型,请重新考虑该类型是否代表逻辑数据存储区。如果该类型不代表逻辑数据存储区,请使用方法。
59、UsePropertiesWhereAppropriate CA1024
在适当的时机使用属性,在大多数情况下,属性代表数据,而方法执行操作。 访问属性的方式与访问字段的方式相似,因此使用它们更容易。 如果存在下列条件之一,方法就很适于成为属性:
不采用任何参数并返回对象的状态信息;
接受单个参数来设置对象的部分状态;
属性的表现应当与字段一样;如果该方法不是这样,则不应将其更改为属性。 在下列情况下,方法比属性更好;
方法执行耗时的操作。 与设置或获取字段值所需的时间相比,此方法的速度明显较慢;
方法执行转换。 访问字段不会返回它所存储的数据的转换版本;
Get 方法会产生明显副作用。 检索字段的值不会产生任何副作用;
执行的顺序很重要。 设置字段的值并不依赖于其他操作的发生;
连续调用两次方法会产生不同的结果;
方法是静态的,但返回了调用方可更改的对象。 调用方不能通过检索某字段的值来更改该字段存储的数据;
方法返回数组。
二、Globalizationrules(区域性规则)2、DoNotHardcodeLocaleSpecificStrings CA1302
System.Environment.SpecialFolder 枚举包含表示特殊系统文件夹的成员。对于不同的操作系统,这些文件夹的位置可能具有不同的值,用户也可能会更改某些位置,或者这些位置已经进行了本地化。例如,System 文件夹就是一个特殊文件夹,该文件夹在 Windows XP 中为“C:\WINDOWS\system32”,而在 Windows 2000 中为“C:\WINNT\system32”。 Environment.GetFolderPath 方法返回与 Environment.SpecialFolder 枚举关联的位置。 GetFolderPath 返回的位置已进行了本地化,以便与目前运行的计算机相适应。该规则将使用 GetFolderPath 方法检索的文件夹路径标记到不同的目录级别。每个字符串都会与这些标记进行比较。如果找到匹配项,则假定该方法正在生成一个与该标记关联的表示系统位置的字符串。为了确保可移植性和可本地化性,请使用 GetFolderPath 方法来检索特殊文件夹的位置,而不要使用字符串。
4、SetLocaleForDataTypes CA1306
区域设置决定数据的区域性特定显示元素,例如,数值、货币符号和排序顺序所用的格式。在创建 DataTable 或 DataSet 时,应显式设置区域设置。默认情况下,这些类型的区域设置为当前区域性。对于存储在数据库或文件中并且全局共享的数据,通常应将区域设置设置为固定区域性 (CultureInfo.InvariantCulture)。当数据跨区域性共享时,使用默认区域设置可能导致 DataTable 或 DataSet 的内容无法正确显示或解释。
5、SpecifyCultureInfo CA1304
指定区域语言,系统启动的时候设置一下当前区域语言里的时间格式,yyyy-MM-dd HH:mm:ss 这样每个画面如果没有给定format的话也不会在win7下出现 3/27/2013。
#region 添加了全局的时间格式化代码 at 2013-4-4 15:09:08 by Anders lu
Thread.CurrentThread.CurrentCulture=(CultureInfo)Thread.CurrentThread.CurrentCulture.Clone();
Thread.CurrentThread.CurrentCulture.DateTimeFormat.ShortDatePattern = "yyyy-MM-dd";
Thread.CurrentThread.CurrentCulture.DateTimeFormat.LongDatePattern = "yyyy-MM-dd";
Thread.CurrentThread.CurrentCulture.DateTimeFormat.ShortTimePattern = "HH:mm:ss";
Thread.CurrentThread.CurrentCulture.DateTimeFormat.LongTimePattern = "HH:mm:ss";
#endregion
6、SpecifyIFormatProvider CA1305
指定IFormatProvider, 同CA1304。
四、Mobilityrules(流动性规则)2、DoNotUseTimersThatPreventPowerStateChanges CA1601
不要以高于每秒一次的频率进行轮询或使用触发频率高于每秒一次的计时器。频率较高的定期活动会使 CPU 处于繁忙状态,并且会干扰具有节能功能(关闭显示器和硬盘)的空闲计时器。
五、Namingrules(命名规则)1、CompoundWordsShouldBeCasedCorrectly CA1702
标识符的名称根据大小写被拆分成几个单词。每两个连续的单词组合由 Microsoft 拼写检查器库进行检查。如果它被识别,该标识符将生成规则冲突。导致冲突的复合词示例包括“CheckSum”和“MultiPart”,它们的大小写分别应为“Checksum”和“Multipart”。由于以前经常使用,规则中置入了一些特例,一些单个的词也会被标记,例如“Toolbar”和“Filename”,应按照大小写规则将它们视为两个不同的单词(即“ToolBar”和“FileName”)。命名约定为所有针对公共语言运行时的库提供了通用的外观。
3、DoNotPrefixEnumValuesWithTypeName CA1712
不要将类型名用作枚举值的前缀,枚举成员的名称不能以类型名称作为前缀,因为类型信息将由开发工具提供。命名约定为所有针对公共语言运行时的库提供了通用的外观。
4、EventsShouldNotHaveBeforeOrAfterPrefix CA1713
事件不应具有 before 或 after 前缀,事件名称应当说明引发事件的操作。若要命名按特定顺序引发的相关事件,请使用现在时或过去时指示一系列操作中的相对位置。例如,当命名关闭资源时引发的一对事件时,可以将其命名为“Closing”和“Closed”,而不是“BeforeClose”和“AfterClose”。
5、FlagsEnumsShouldHavePluralNames CA1714
Flags 枚举应采用复数形式的名称,标有 FlagsAttribute 的类型具有复数形式的名称,因为该特性指明可以指定多个值。例如,定义星期几的枚举可能打算在可以指定多天的应用程序中使用。此枚举应具有FlagsAttribute 并且可称为“Days”。只允许指定一天的类似枚举将没有该特性,并可称为“Day”。
6、IdentifiersShouldBeCasedCorrectly CA1709
标识符的大小写应当正确,命名约定为所有针对公共语言运行时的库提供了通用的外观。
按照约定,参数名使用 Camel 大小写;命名空间、类型和成员名称使用 Pascal 大小写。在采用 Camel 大小写格式的名称中,第一个字母为小写,名称中其他所有单词的第一个字母为大写。Camel 大小写形式的名称示例为“packetSniffer”、“ioFile”和“fatalErrorCode”。在采用 Pascal 大小写格式的名称中,第一个字母为大写,名称中其他所有单词的第一个字母为大写。Pascal 大小写形式的名称示例为“PacketSniffer”、“IOFile”和“FatalErrorCode”。
该规则根据大小写将名称拆分为若干单词,并依据常见的双字母单词(例如“In”或“My”)列表来检查所有双字母单词。如果未找到匹配项,则假定该单词是首字母缩略词。此外,此规则假定发现一个首字母缩略词,其名称在一行中包含四个大写字母,或在名称的结尾发现一行中有三个大写字母。
按照约定,双字母的首字母缩略词全部使用大写字母,含三个或三个以上字符的首字母缩略词则使用 Pascal 大小写形式。下面的示例使用该命名约定:“DB”、“CR”、“Cpa”和“Ecma”。下面的示例与该约定冲突:“Io”、“XML”和“DoD”;对于非参数名称,冲突的示例有“xp”和“cpl”。
“ID”是一种导致与该规则冲突的特殊情况。'Id”不是首字母缩略词,而是“identification”的缩写。
7、IdentifiersShouldBeSpelledCorrectly CA1704
标识符应正确拼写,此规则将标识符解析为标记并检查每个标记的拼写。解析算法执行下列转换:
一个新标记以大写字母开头。例如,MyNameIsJoe 被解析为“My”、“Name”、“Is”和“Joe”标记。
对于多个大写字母,最后一个大写字母开始一个新标记。例如,GUIEditor 被解析为“GUI”和“Editor”标记。
移除前导和尾随撇号。例如,“'sender'”被解析为“sender”标记。
下划线表示一个标记的结尾,并被移除。例如,Hello_world 被解析为“Hello”和“world”标记。
嵌入的与号将被移除。例如,for&mat 被解析为“format”标记。
默认情况下,使用拼写检查器的英语 (en) 版本。目前没有其他语言字典。
8、IdentifiersShouldDifferByMoreThanCase CA1708
标识符不应仅以大小写进行区分,不能仅通过大小写区分命名空间、类型、成员和参数的标识符,因为针对公共语言运行时的语言不需要区分大小写。
9、IdentifiersShouldHaveCorrectPrefix CA1715
标识符应具有正确的前缀,按照约定,某些编程元素的名称以特定前缀开头。
接口名称应以大写字母“I”开头,后跟另一个大写字母。泛型类型参数名称应以大写字母“T”开头,后面可跟另一个大写字母。
10、IdentifiersShouldHaveCorrectSuffix CA1715
标识符应具有正确的后缀,
基类型/接口
后缀
System.Attribute
特性
System.EventArgs
EventArgs
System.Exception
异常
System.Collections.ICollection
Collection
System.Collections.IDictionary
Dictionary
System.Collections.IEnumerable
Collection
System.Collections.Queue
Collection 或 Queue
System.Collections.Stack
Collection 或 Stack
System.Collections.Generic.ICollection<T>
Collection
System.Collections.Generic.IDictionary<TKey, TValue>
Dictionary
System.Data.DataSet
数据集
System.Data.DataTable
Collection 或 DataTable
System.IO.Stream
流
System.Security.IPermission
权限
System.Security.Policy.IMembershipCondition
Condition
事件处理程序委托。
EventHandler
11、IdentifiersShouldNotContainTypeNames CA1720
标识符不应包含类型名称。
12、IdentifiersShouldNotContainUnderscores CA1707
标识符不应包含下滑线。
13、IdentifiersShouldNotHaveIncorrectPrefix CA1722
与CA1715对应
14、IdentifiersShouldNotHaveIncorrectSuffix CA1711
与CA1710对应
15、IdentifiersShouldNotMatchKeywords CA1716
标识符不应与关键字冲突。
16、OnlyFlagsEnumsShouldHavePluralNames CA1717
只有 FlagsAttribute 枚举应采用复数形式的名称。命名约定规定,复数形式的枚举名称表示可以同时指定多个枚举值。 FlagsAttribute 通知编译器应将枚举视为一个位字段,允许对枚举执行按位运算。
如果一次只能指定一个枚举值,枚举的名称应为单数形式的单词。例如,定义星期几的枚举可能打算在可以指定多天的应用程序中使用。此枚举应具有 FlagsAttribute 并且可称为“Days”。只允许指定一天的类似枚举将没有该特性,并可称为“Day”。
17、ParameterNamesShouldMatchBaseDeclaration CA1725
参数名应与基方法中的声明保持一致。
18、ParameterNamesShouldNotMatchMemberNames CA1719
参数名不应与成员名冲突。
19、PropertyNamesShouldNotMatchGetMethods CA1721
属性名不应与 get 方法冲突,造成的原因,公共或受保护成员的名称以“Get”开头,且其余部分与公共或受保护属性的名称匹配。例如,包含名为“GetColor”的方法和名为“Color”的属性的类型与该规则冲突。
20、ResourceStringCompoundWordsShouldBeCasedCorrectly CA1701
资源字符串应该采取正确的大小写,
21、ResourceStringsShouldBeSpelledCorrectly CA1703
资源字符串应该采取正确的大小写,
22、TypeNamesShouldNotMatchNamespaces CA1724
类型名不应与命名空间冲突
23、UsePreferredTerms CA1726
使用首选词条,此规则将标识符分析为标记。将对照规则中内置的词条(位于任何自定义字典的“已否决”部分)比较每个单一标记和每个连续的双标记组合。下表演示该规则中内置的词条以及它们的首选备用词条。
过时的词条
首选词条
Arent
AreNot
Cancelled
Canceled
Cant
Cannot
ComPlus
EnterpriseServices
Couldnt
CouldNot
Didnt
DidNot
Doesnt
DoesNot
Dont
DoNot
Flag 或 Flags
无替代词条。不使用。
Hadnt
HadNot
Hasn’t
HasNot
Havent
HaveNot
Indices
Indexes
Isnt
IsNot
LogIn
LogOn
LogOut
LogOff
Shouldnt
ShouldNot
SignOn
SignIn
SignOff
SignOut
Wasnt
WasNot
Werent
WereNot
Wont
WillNot
Wouldnt
WouldNot
Writeable
Writable
六、Performancerules(性能规则)1、AvoidExcessiveLocals CA1809
避免过多的局部变量,优化性能的常见方法是将值存储于处理器寄存器,而不是内存中,这称为“注册值”。公共语言运行时最多可考虑注册 64 个局部变量。未注册的变量放在堆栈中,必须移到寄存器内方能进行操作。若要提供所有的局部变量都能注册的机会,应将局部变量的数目限制在 64 个以内。
2、AvoidUncalledPrivateCode CA1811
避免使用未调用的私有代码。
3、AvoidUninstantiatedInternalClasses CA1812
避免未实例化的内部类
4、AvoidUnsealedAttributes CA1813
避免使用未密封的特性
5、DoNotCastUnnecessarily CA1800
避免进行不必要的强制转换,重复强制转换会降低性能,特别是在精简的迭代语句中执行强制转换时。对于显式重复强制转换操作,将强制转换的结果存储在局部变量中,并使用局部变量来替代重复强制转换操作。
6、InitializeReferenceTypeStaticFieldsInline CA1810
以内联方式初始化引用类型的静态字段,当一个类型声明显式静态构造函数时,实时 (JIT) 编译器会向该类型的每个静态方法和实例构造函数中添加一项检查,以确保之前已调用该静态构造函数。访问任何静态成员或创建了类型实例时,都会触发静态初始化。示例用法:
public class NoStaticConstructor { static int someInteger = 3; static string resourceString = InitializeResourceString(); static string InitializeResourceString() { ResourceManager stringManager = new ResourceManager("strings", Assembly.GetExecutingAssembly()); return stringManager.GetString("string"); } }
7、MarkMembersAsStatic CA1822
将成员标记为 static,可以将不访问实例数据或不调用实例方法的成员标记为 static(在 Visual Basic 中为 Shared)。在将这些方法标记为 static 之后,编译器将向这些成员发出非虚拟调用站点。发出非虚拟调用站点将禁止在运行时对每个调用进行检查,从而确保当前的对象指针为非空。这会使性能敏感的代码的性能得到显著提高。在某些情况下,如果无法访问当前的对象实例,则表示存在正确性问题。
8、OverrideEqualsAndOperatorEqualsOnValueTypes CA1815
重写值类型上的 Equals 和相等运算符。对于值类型,Equals 的继承的实现使用反射库,并比较所有字段的内容。反射需要消耗大量计算资源,可能没有必要比较每一个字段是否相等。如果希望用户对实例进行比较或排序,或者希望用户将其作为哈希表键,则值类型必须实现 Equals。如果编程语言支持运算符重载,则还应提供等号和不等号运算符的实现。
9、PreferJaggedArraysOverMultidimensional CA1814
与多维数组相比,首选使用交错的数组,交错数组是元素为数组的数组。构成元素的数组可以是不同的大小,以减少某些数据集的浪费空间。
10、 PropertiesShouldNotReturnArrays CA1819
属性不应返回数组,即使属性是只读的,该属性返回的数组也不是写保护的。若要使数组不会被更改,属性必须返回数组的副本
11、 RemoveEmptyFinalizers CA1821
应尽可能避免析构函数,因为跟踪对象生存期会产生额外的性能系统开销。垃圾收集器将在收集该对象之前运行析构函数。这意味着收集该对象需要两个集合。空的终结器只会徒增这种系统开销,而没有一点好处。如果进行调试时需要一个终结器,请将整个终结器括在 #if DEBUG / #endif 指令中。
12、RemoveUnusedLocals CA1804
移除未使用的局部变量
13、TestForEmptyStringsUsingStringLength CA1820
使用字符串长度测试是否有空字符串,使用 String.Length 属性或 String.IsNullOrEmpty 方法比较字符串要比使用 Equals 的速度快得多。这是因为与 IsNullOrEmpty 或者为检索 Length 属性值并将其与零比较所需执行的指令数相比,Equals 执行更多的 MSIL 指令。
八、Securityrule(安全性规则)1、CallGCKeepAliveWhenUsingNativeResources CA2115
处理 Exception 的 catch 块会捕获所有符合公共语言规范 (CLS) 的异常。但是,它不捕获不符合 CLS 的异常。
try{ThrowsExceptions.ThrowNonClsException();}
catch(Exception e) {// Remove some permission.
Console.WriteLine("CLS compliant exception caught"); }
catch{// Remove the same permission as above. Console.WriteLine("Non-CLS compliant exception caught."); }
2、DoNotDeclareReadOnlyMutableReferenceTypes CA2104
不要声明只读可变引用类型,举例:static protected readonly StringBuilder SomeStringBuilder;
FxCop的安装文件,规则的翻译,建议采纳项目列表,以及"采纳项目列表"的*.FxCop文件可以从我的资源中下载:FxCop整套资料下载