디자인 규칙

디자인 규칙은 .NET Framework 디자인 지침을 준수하도록 지원합니다.

이 섹션의 내용

규칙	설명
CA1000: 정적 멤버를 제네릭 형식으로 선언하지 마십시오.	제네릭 형식의 정적 멤버를 호출할 때는 형식에 형식 인수를 지정해야 합니다. 유추를 지원하지 않는 제네릭 인스턴스 멤버를 호출할 때는 멤버에 형식 인수를 지정해야 합니다. 이 두 가지 경우에 형식 인수를 지정하기 위한 구문은 서로 다르며 혼동되기 쉽습니다.
CA1001: 삭제 가능한 필드가 있는 형식은 삭제 가능해야 합니다.	클래스가 System.IDisposable 형식인 인스턴스 필드를 선언하고 구현하지만 IDisposable은 구현하지 않습니다. IDisposable 필드를 선언하는 클래스는 관리되지 않는 리소스를 간접적으로 소유하며 IDisposable 인터페이스를 구현해야 합니다.
CA1002: 제네릭 목록을 노출하지 마십시오.	System.Collections.Generic.List<(Of <(T>))>는 상속이 아닌 성능을 위해 설계된 제네릭 컬렉션입니다. 따라서 List에는 가상 멤버가 포함되지 않습니다. 상속을 위해 디자인된 제네릭 컬렉션이 대신 노출되어야 합니다.
CA1003: 제네릭 이벤트 처리기 인스턴스를 사용하십시오.	void를 반환하며 해당 시그니처에 두 개의 매개 변수(개체가 첫 번째 및 두 번째는 EventArgs에 할당될 수 있는 형식)를 포함하는 대리자를 포함하는 형식을 포함하는 어셈블리에는 .NET Framework 2.0 대상으로 합니다.
CA1005: 제네릭 형식에 매개 변수를 너무 많이 사용하지 마십시오.	제네릭 형식에 포함된 형식 매개 변수가 많을수록 각 형식 매개 변수가 무엇을 나타내는지를 파악하거나 기억하기가 더 어렵습니다. 일반적으로 List<T에서와 같이 하나의 형식 매개 변수와 사전 TKey, TValue>>에서처럼 두 개의 형식 매개 변수가 있는<경우에 분명합니다. 그러나 형식 매개 변수가 세 개 이상이면 대부분의 사용자가 사용하기에 너무 어렵습니다.
CA1008: 열거형에는 0 값이 있어야 합니다.	초기화되지 않은 열거형의 기본값은 다른 값 형식과 마찬가지로 0입니다. 플래그 특성을 사용하지 않는 열거형에서는 기본값이 열거형의 유효한 값이 되도록 0 값을 사용하여 멤버를 정의해야 합니다. FlagsAttribute 특성이 적용된 열거형에서 0 값을 가진 멤버를 정의하는 경우에는 열거형에 값이 설정되지 않았음을 나타낼 수 있도록 해당 멤버 이름이 "None"이어야 합니다.
CA1010: 컬렉션은 제네릭 인터페이스를 구현해야 합니다.	컬렉션의 유용성을 높이려면 제네릭 컬렉션 인터페이스 중 하나를 구현합니다. 그러면 컬렉션을 사용하여 제네릭 컬렉션 형식을 채울 수 있습니다.
CA1012: 추상 형식에는 공용 생성자가 없어야 합니다.	추상 형식에 대한 생성자는 파생된 형식에서만 호출할 수 있습니다. public 생성자에서 형식의 인스턴스를 만들고 사용자는 추상 형식의 인스턴스를 만들 수 없기 때문에 public 생성자가 있는 추상 형식은 잘못 디자인된 것입니다.
CA1014: 어셈블리를 CLSCompliantAttribute로 표시하십시오.	CLS(공용 언어 사양)는 어셈블리가 여러 프로그래밍 언어에 사용될 경우 준수해야 하는 명명 제한, 데이터 형식 및 규칙을 정의합니다. 모든 어셈블리에는 CLSCompliantAttribute를 사용하여 CLS 규격을 명시적으로 나타내는 것이 좋습니다. 어셈블리에 이 특성이 없으면 해당 어셈블리는 규격을 따르지 않습니다.
CA1016: 어셈블리를 AssemblyVersionAttribute로 표시하십시오.	.NET에서는 버전 번호를 사용하여 어셈블리를 고유하게 식별하고 강력한 이름의 어셈블리에 있는 형식에 바인딩합니다. 버전 번호는 버전 및 게시자 정책과 함께 사용됩니다. 기본적으로 애플리케이션은 해당 애플리케이션이 빌드될 때 사용된 어셈블리 버전으로만 실행됩니다.
CA1017: 어셈블리를 ComVisibleAttribute로 표시하십시오.	ComVisibleAttribute는 COM 클라이언트에서 관리 코드에 액세스하는 방식을 결정합니다. 어셈블리에서 COM에 노출할지 여부를 명시적으로 나타내는 것이 좋은 디자인입니다. 전체 어셈블리에 대해 COM 노출 여부를 설정한 다음 개별 형식 및 형식 멤버에 대해 이를 재정의할 수 있습니다. 이 특성이 없으면 COM 클라이언트에서 어셈블리의 내용을 볼 수 있습니다.
CA1018: 특성을 AttributeUsageAttribute로 표시하십시오.	사용자 지정 특성을 정의할 때는 해당 특성을 AttributeUsageAttribute로 표시하여 사용자 지정 특성을 적용할 수 있는 소스 코드의 위치를 나타냅니다. 특성의 의미 및 용도에 따라 코드에서의 유효한 위치가 결정됩니다.
CA1019: 특성 인수의 접근자를 정의하십시오.	특성에서는 대상에 특성을 적용할 때 지정해야 하는 필수 인수를 정의할 수 있습니다. 이러한 인수는 특성 생성자에 위치 매개 변수로 제공되기 때문에 이러한 인수를 위치 인수라고도 합니다. 모든 필수 인수에 대해 특성은 실행 시간에 인수의 값을 검색할 수 있도록 해당하는 읽기 전용 속성도 제공해야 합니다. 특성에서는 명명된 인수라고 하는 선택적 인수도 정의할 수 있습니다. 이들 인수는 이름으로 특성 생성자에 제공되며 해당하는 읽기/쓰기 특성이 있어야 합니다.
CA1021: out 매개 변수를 사용하지 마십시오.	out 또는 ref를 사용하여 참조로 형식을 전달하려면 포인터 사용 방법을 알고 있어야 하고, 값 형식과 참조 형식이 어떻게 다른지 알고 있어야 하며, 반환 값이 여러 개인 메서드를 처리할 수 있어야 합니다. 또한 out 매개 변수와 ref 매개 변수의 차이점은 잘 알려져 있지 않습니다.
CA1024: 적합한 속성을 사용하십시오.	public 또는 protected 메서드가 "Get"으로 시작하는 이름을 사용하고, 매개 변수를 사용하지 않으며, 배열이 아닌 값을 반환합니다. 이 메서드는 속성이 될 수 있는 좋은 예일 수 있습니다.
CA1027: 열거형을 FlagsAttribute로 표시하십시오.	열거형은 서로 관련 있는 명명된 상수 집합을 정의하는 값 형식입니다. 명명된 상수를 의미 있게 조합할 수 있는 경우 열거형에 FlagsAttribute를 적용합니다.
CA1028: 열거형 스토리지는 Int32여야 합니다.	열거형은 서로 관련 있는 명명된 상수 집합을 정의하는 값 형식입니다. 기본적으로 System.Int32 데이터 형식은 상수 값을 저장하는 데 사용됩니다. 해당 내부 형식을 변경할 수 있지만 대부분의 시나리오에서는 변경이 필요하지 않거나 권장되지 않습니다.
CA1030: 적절한 경우 이벤트를 사용하십시오.	이 규칙에서는 보통 이벤트에 사용되는 이름을 갖는 메서드를 찾아냅니다. 명확하게 정의된 상태 변경에 대한 응답으로 메서드를 호출할 경우 이 메서드는 이벤트 처리기에서 호출해야 합니다. 메서드를 호출하는 개체는 메서드를 직접 호출하는 대신 이벤트를 발생시켜야 합니다.
CA1031: 일반적인 예외 형식을 catch하지 마십시오.	일반 예외는 catch하면 안 됩니다. 더욱 구체적인 예외를 catch하거나, 일반적인 예외를 catch 블록의 마지막 문으로 다시 throw해야 합니다.
CA1032: 표준 예외 생성자를 구현하십시오.	이들 생성자 집합을 전부 제공하지 못하면 예외를 제대로 처리하기 어려울 수 있습니다.
CA1033: 인터페이스 메서드는 자식 형식에서 호출할 수 있어야 합니다.	외부에서 볼 수 있는 unsealed 형식이 public 인터페이스의 명시적 메서드 구현을 제공하면서 외부에서 볼 수 있는 같은 이름의 대체 메서드를 제공하지 않습니다.
CA1034: 중첩 형식은 노출하지 마십시오.	중첩 형식은 다른 형식의 범위 내에 선언된 형식입니다. 중첩 형식은 포함하는 형식의 private 구현 정보를 캡슐화하는 데 유용합니다. 이 용도로 사용할 경우 중첩 형식은 외부에 노출되면 안 됩니다.
CA1036: 비교 가능한 형식에 메서드를 재정의하십시오.	public 또는 protected 형식이 System.IComparable 인터페이스를 구현합니다. 이 형식은 Object.Equals를 재정의하지 않으며 같음, 같지 않음, 보다 작음 또는 보다 큼에 대한 언어별 연산자를 오버로드하지 않습니다.
CA1040: 빈 인터페이스를 사용하지 마십시오.	인터페이스에서는 동작이나 사용 계약을 제공하는 멤버를 정의합니다. 인터페이스에 의해 설명되는 기능은 상속 계층 구조에서 형식이 나타나는 위치에 관계없이 모든 형식에서 사용할 수 있습니다. 형식에서는 인터페이스의 멤버에 대한 구현을 제공하여 인터페이스를 구현합니다. 빈 인터페이스는 멤버를 정의하지 않으므로 구현 가능한 계약을 정의하지 않습니다.
CA1041: ObsoleteAttribute 메시지를 제공하십시오.	형식 또는 멤버가 ObsoleteAttribute.Message 속성이 지정되지 않은 System.ObsoleteAttribute 특성으로 표시되어 있습니다. ObsoleteAttribute를 사용하여 표시된 형식 또는 멤버를 컴파일하면 특성의 메시지 속성이 표시되어 사용되지 않는 형식 또는 멤버에 대한 정보를 사용자에게 제공합니다.
CA1043: 인덱서에 정수 또는 문자열 인수를 사용하십시오.	인덱서, 즉 인덱싱된 속성은 인덱스에 정수 계열 형식이나 문자열 형식을 사용해야 합니다. 이러한 형식은 대개 데이터 구조를 인덱싱하는 데 사용되며 라이브러리의 유용성을 증가시킵니다. Object 형식은 디자인 타임에 특정 정수 계열 형식이나 문자열 형식을 지정할 수 없는 경우에만 제한적으로 사용해야 합니다.
CA1044: 속성은 쓰기 전용이면 안 됩니다.	읽기 전용 속성을 사용하는 것은 가능하고 종종 필요하기도 하지만 쓰기 전용 속성의 사용은 금지되어 있습니다. 사용자에게 값을 설정하도록 허용한 다음 해당 값을 볼 수 없도록 하면 보안상 문제가 있기 때문입니다. 또한 읽기 권한이 없으면 공유 개체의 상태를 볼 수 없으므로 사용하는 데 제한을 받습니다.
CA1045: 참조로 참조 형식을 전달하지 않습니다.	out 또는 ref를 사용하여 참조로 형식을 전달하려면 포인터 사용 방법을 알고 있어야 하고, 값 형식과 참조 형식이 어떻게 다른지 알고 있어야 하며, 반환 값이 여러 개인 메서드를 처리할 수 있어야 합니다. 일반 사용자를 대상으로 디자인하는 라이브러리 설계자는 사용자가 out 또는 ref 매개 변수를 사용하는 작업에 능숙해질 것으로 기대해서는 안 됩니다.
CA1046: 참조 형식에 같음 연산자를 오버로드하지 마십시오.	참조 형식의 경우 같음 연산자의 기본 구현은 대부분 항상 올바릅니다. 기본적으로 두 참조는 같은 개체를 가리킬 경우에만 같습니다.
CA1047: protected 멤버를 sealed 형식으로 선언하지 마십시오.	형식에서는 상속하는 형식에서 멤버에 액세스하거나 멤버를 재정의할 수 있도록 하기 위해 protected 멤버를 선언합니다. 정의에 따라 sealed 형식은 상속할 수 없으므로 sealed 형식에 대해 protected 메서드를 호출할 수 없습니다.
CA1050: 네임스페이스에 형식을 선언하십시오.	이름 충돌을 방지하고 관련된 형식을 개체 계층 구조로 구성하기 위해 형식은 네임스페이스 안에 선언됩니다.
CA1051: 표시되는 인스턴스 필드를 선언하지 마십시오.	필드의 주된 용도는 구현을 세부적으로 설명하는 것입니다. 필드는 private 또는 internal이어야 하고 속성을 통해 노출되어야 합니다.
CA1052: 정적 소유자 형식은 sealed여야 합니다.	public 형식 또는 protected 형식이 정적 멤버만 포함하며 sealed(C#) 또는 NotInheritable(Visual Basic) 한정자로 선언되지 않았습니다. 상속을 고려하지 않은 형식은 sealed 한정자로 표시하여 기본 형식으로 사용되지 않도록 해야 합니다.
CA1053: 정적 소유자 형식에는 생성자를 사용하면 안 됩니다.	public 또는 중첩된 public 형식에서 정적 멤버만 선언하며 public 또는 protected 기본 생성자를 사용합니다. 호출하는 정적 멤버에 형식의 인스턴스가 필요하지 않기 때문에 생성자가 필요 없습니다. 문자열 오버로드는 안전과 보안을 위해 문자열 인수를 사용하여 URI(Uniform Resource Identifier) 오버로드를 호출해야 합니다.
CA1054: URI 매개 변수는 문자열이면 안 됩니다.	메서드가 URI의 문자열 표현을 사용하면 URI 클래스의 인스턴스를 사용하는 해당 오버로드를 제공해야 합니다. 이렇게 하면 서비스가 안전한 방식으로 제공됩니다.
CA1055: URI 반환 값은 문자열이면 안 됩니다.	이 규칙에서는 메서드가 URI를 반환한다고 가정합니다. URI의 문자열 표현은 구문 분석 및 인코딩 오류를 발생시키기 쉬우며 보안 문제를 일으킬 수 있습니다. System.Uri 클래스는 이러한 서비스를 안전한 방식으로 제공합니다.
CA1056: URI 속성은 문자열이면 안 됩니다.	이 규칙에서는 속성이 URI를 나타낸다고 가정합니다. URI의 문자열 표현은 구문 분석 및 인코딩 오류를 발생시키기 쉬우며 보안 문제를 일으킬 수 있습니다. System.Uri 클래스는 이러한 서비스를 안전한 방식으로 제공합니다.
CA1058: 형식은 특정 기본 형식을 확장하면 안 됩니다.	외부에서 볼 수 있는 형식이 특정 기본 형식을 확장합니다. 다음 방법 중 하나를 사용합니다.
CA1060: P/Invoke를 NativeMethods 클래스로 이동	System.Runtime.InteropServices.DllImportAttribute로 표시된 메서드나 Visual Basic에서 Declare 키워드를 사용하여 정의된 메서드 같은 플랫폼 호출 메서드에서는 비관리 코드에 액세스합니다. 이러한 메서드는 NativeMethods, SafeNativeMethods 또는 UnsafeNativeMethods 클래스에 속해야 합니다.
CA1061: 기본 클래스 메서드를 숨기지 마십시오.	파생된 메서드의 매개 변수 시그니처가 기본 메서드의 매개 변수 시그니처에 있는 해당 형식보다 더 약하게 파생된 형식이라는 점만 다른 경우 기본 형식의 메서드는 파생된 형식에 있는 동일한 이름의 메서드에 의해 숨겨집니다.
CA1062: public 메서드의 인수의 유효성을 검사하십시오.	외부에서 볼 수 있는 메서드에 전달되는 모든 참조 인수는 null인지 여부를 검사해야 합니다.
CA1063: IDisposable을 올바르게 구현하십시오.	모든 IDisposable 형식은 Dispose 패턴을 올바르게 구현해야 합니다.
CA1064: 예외는 public이어야 합니다.	내부 예외는 내부 범위 내에만 표시됩니다. 예외가 내부 범위 밖에 놓이게 되면 예외를 catch하는 데 기본 예외만 사용할 수 있습니다. 내부 예외에서 상속 되 면 System.Exception, System.SystemException, 또는 System.ApplicationException, 외부 코드에 예외를 사용 하 여 수행할 작업을 알고에 충분 한 정보가 없습니다.
CA1065: 예기치 않은 위치에서 예외를 발생시키지 마십시오.	예외를 throw하지 않아야 하는 메서드가 예외를 throw했습니다.
CA1066: Equals를 재정의할 때 IEquatable 구현	값 형식은 Equals 메서드를 재정의하지만 IEquatable<T>를 구현하지는 않습니다.
CA1067: IEquatable을 구현할 때 등호 재정의	형식은 IEquatable<T>을 구현하지만 Equals 메서드를 재정의하지 않습니다.
CA1068: CancellationToken 매개 변수가 마지막으로 와야 합니다.	메서드에 마지막 매개 변수가 아닌 CancellationToken 매개 변수가 있습니다.
CA1069: 열거형에는 중복 값이 없어야 합니다.	열거형에는 동일한 상수 값을 명시적으로 할당받은 여러 멤버가 있습니다.
CA1070: 이벤트 필드를 가상으로 선언하지 마세요.	필드와 유사한 이벤트가 가상으로 선언되었습니다.