CA1002:不要公开泛型列表

类型名

DoNotExposeGenericLists

CheckId

CA1002

类别

Microsoft.Design

是否重大更改

原因

某个类型包含一个 System.Collections.Generic.List<T> 类型的外部可见成员,返回一个 System.Collections.Generic.List<T> 类型,或者其签名包括 System.Collections.Generic.List<T> 参数。

规则说明

System.Collections.Generic.List<T> 是针对性能(而非继承)设计的泛型集合。 System.Collections.Generic.List<T> 不包含更便于更改继承类的行为的虚拟成员。 下面的泛型集合是针对继承功能设计的,应公开为 System.Collections.Generic.List<T> 以外的内容。

如何解决冲突

若要修复与该规则的冲突,请将 System.Collections.Generic.List<T> 类型更改为针对继承功能设计的泛型集合之一。

何时禁止显示警告

除非引发此警告的程序集不应当为可重用的库,否则不要禁止显示此规则发出的警告。 例如,对于因使用泛型列表而使性能得到优化的应用程序,可以安全地禁止显示此警告。

相关规则

CA1005:避免泛型类型的参数过多

CA1010:集合应实现泛型接口

CA1000:不要在泛型类型中声明静态成员

CA1006:不要将泛型类型嵌套在成员签名中

CA1004:泛型方法应提供类型参数

CA1003:使用泛型事件处理程序实例

CA1007:在适用处使用泛型

请参见

参考

泛型(C# 编程指南)