避免泛型类型的参数过多
更新：2007 年 11 月
TypeName |
AvoidExcessiveParametersOnGenericTypes |
CheckId |
CA1005 |
类别 |
Microsoft.Design |
是否重大更改 |
是 |
原因
外部可见的泛型类型具有两个以上的类型参数。
规则说明
泛型类型包含的类型参数越多，越难以知道并记住每个类型参数各代表什么。包含一个类型参数通常很显然，如在 List<T> 中，在某些情况下包含两个类型参数也很显然，如在 Dictionary<TKey, TValue> 中。如果有两个以上的类型参数，则大多数用户都会感到太困难，例如 C# 中的 TooManyTypeParameters<T, K, V> 或 Visual Basic 中的 TooManyTypeParameters(Of T, K, V)。
如何修复冲突
若要修复与该规则的冲突，请更改设计以确保使用的类型参数不超过两个。
何时禁止显示警告
除非设计确实需要两个以上的类型参数，否则不要禁止显示此规则发出的警告。按照容易理解和使用的语法提供泛型，不仅可以缩短学习新库所需的时间，而且还可以提高新库的使用率。
示例
下面的示例演示一个类，该类定义 3 个与此规则冲突的泛型类型参数。
Imports System
Namespace Samples
' Violates this rule
Public Class Tuple(Of T1, T2, T3)
End Class
End Namespace
using System;
namespace Samples
{
// Violates this rule
public class Tuple<T1, T2, T3>
{
}
}
using namespace System;
namespace Samples
{
// Violaties this rule
generic <typename T1, typename T2, typename T3>
public ref class Tuple
{
};
}