不要公开泛型列表

更新:2007 年 11 月

TypeName

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> 类型更改为针对继承功能设计的泛型集合之一。

何时禁止显示警告

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

相关规则

避免泛型类型的参数过多

集合应实现泛型接口

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

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

泛型方法应提供类型参数

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

在适用处使用泛型

请参见

参考

泛型(C# 编程指南)