CA1005：避免在泛型型別上包含過多參數
型別名稱 |
AvoidExcessiveParametersOnGenericTypes |
CheckId |
CA1005 |
分類 |
Microsoft.Design |
中斷變更 |
中斷 |
原因
外部可見的泛型型別具有兩個以上的型別參數。
規則描述
泛型型別所包含的型別參數越多，就越難了解並記住每個型別參數所代表的含意。 若是只包含一種型別參數 (如 List<T>)，以及包含兩個型別參數的某些特定情況 (如 Dictionary<TKey, TValue>)，這些通常都清楚易懂。 如果有兩個以上的型別參數存在，則對大多數使用者而言都會變得難以理解 (例如 C# 中的 TooManyTypeParameters<T, K, V> 或 Visual Basic 的 TooManyTypeParameters(Of T, K, V))。
如何修正違規
若要修正此規則的違規情形，請將設計變更為只使用兩個以下的型別參數。
隱藏警告的時機
除非設計上絕對需要兩個以上的型別參數，否則請勿隱藏此規則的警告。 使用易於了解和使用的語法提供泛型，以便減少學習所需的時間，並增加新程式庫的採用率。