首页 诗词 字典 板报 句子 名言 友答 励志 学校 网站地图
当前位置: 首页 > 教程频道 > 软件管理 > 软件开发 >

代码审查工具FxCop提议采用的规则总结

2013-04-12 
代码审查工具FxCop建议采用的规则总结续接:代码走查工具篇FxCop的规则总结与翻译_Part1 代码走查工具篇FxC

代码审查工具FxCop建议采用的规则总结

续接:

   代码走查工具篇FxCop的规则总结与翻译_Part1

 代码走查工具篇FxCop的规则总结与翻译_Part2

代码走查工具篇FxCop的规则总结与翻译_Part3


   本篇结合我的实际工作需要,总结了一份在实际工作中采纳的规则项目,总结不妥之处,还请多海涵。

一、Design Rules(设计规约)

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整套资料下载


热点排行