다음을 통해 공유


CA1005: 제네릭 형식에 매개 변수를 너무 많이 사용하지 마십시오.

TypeName

AvoidExcessiveParametersOnGenericTypes

CheckId

CA1005

범주

Microsoft.Design

변경 수준

주요 변경

원인

외부에서 볼 수 있는 제네릭 형식에 세 개 이상의 형식 매개 변수가 있습니다.

규칙 설명

제네릭 형식에 포함된 형식 매개 변수가 많을수록 각 형식 매개 변수가 무엇을 나타내는지를 파악하거나 기억하기가 더 어렵습니다.보통은 List<T>에서처럼 하나의 형식 매개 변수를 사용하고 특정한 경우에는 Dictionary<TKey, TValue>에서처럼 두 개의 형식 매개 변수를 사용하는 것이 좋습니다.형식 매개 변수가 세 개 이상이면 대부분의 사용자가 사용하기에 너무 어렵습니다(예를 들어, C#의 경우 TooManyTypeParameters<T, K, V> 또는 Visual Basic의 경우 TooManyTypeParameters(Of T, K, V)).

위반 문제를 해결하는 방법

이 규칙 위반 문제를 해결하려면 디자인을 변경하여 세 개 이상의 형식 매개 변수를 사용하지 않도록 합니다.

경고를 표시하지 않는 경우

디자인에 반드시 세 개 이상의 형식 매개 변수가 필요한 경우가 아니라면 경고를 표시하십시오.제네릭을 이해하고 사용하기 쉬운 구문으로 제공하면 학습에 걸리는 시간이 줄어들고 더 많은 사용자가 새로운 라이브러리를 선택하게 됩니다.

관련 규칙

CA1010: 컬렉션은 제네릭 인터페이스를 구현해야 합니다.

CA1000: 정적 멤버를 제네릭 형식으로 선언하지 마십시오.

CA1002: 제네릭 목록을 노출하지 마십시오.

CA1006: 멤버 시그니처에 제네릭 형식을 중첩하지 마십시오.

CA1004: 제네릭 메서드는 형식 매개 변수를 제공해야 합니다.

CA1003: 제네릭 이벤트 처리기 인스턴스를 사용하십시오.

CA1007: 적합한 제네릭을 사용하십시오.

참고 항목

참조

제네릭(C# 프로그래밍 가이드)