CA1005:避免泛型类型的参数过多
类型名 |
AvoidExcessiveParametersOnGenericTypes |
CheckId |
CA1005 |
类别 |
Microsoft.Design |
是否重大更改 |
是 |
原因
外部可见的泛型类型具有两个以上的类型参数。
规则说明
泛型类型包含的类型参数越多,越难以知道并记住每个类型参数各代表什么。 包含一个类型参数通常很显然,如在 List<T> 中,在某些情况下包含两个类型参数也很显然,如在 Dictionary<TKey, TValue> 中。 但是,如果存在两个以上的类型参数,则大多数用户都会感到过于困难(例如,C# 中的 TooManyTypeParameters<T, K, V> 或 Visual Basic 中的 TooManyTypeParameters(Of T, K, V))。
如何解决冲突
若要修复与该规则的冲突,请更改设计以确保使用的类型参数不超过两个。
何时禁止显示警告
除非设计确实需要两个以上的类型参数,否则不要禁止显示此规则发出的警告。 按照容易理解和使用的语法提供泛型,不仅可以缩短学习新库所需的时间,而且还可以提高新库的使用率。