관리 코드에 대한 기본 디자인 지침 규칙 규칙 집합
Microsoft 기본 디자인 지침 규칙이라는 규칙 집합을 사용하면 코드를 보다 쉽게 이해하고 사용할 수 있게 만드는 데 초점을 맞출 수 있습니다.프로젝트에 라이브러리 코드가 있거나 유지 관리하기 쉬운 코드를 만들기 위해 모범 사례를 적용하려는 경우 이 규칙 집합을 포함해야 합니다.
기본 디자인 지침 규칙에는 Microsoft 최소 권장 규칙이라는 규칙 집합의 규칙이 모두 포함됩니다.최소 규칙의 목록을 보려면 관리 코드에 대한 관리 권장 규칙 규칙 집합을 참조하십시오.
다음 표에서는 Microsoft 기본 디자인 지침 규칙 집합의 모든 규칙에 대해 설명합니다.
규칙 |
설명 |
---|---|
삭제 가능한 필드가 있는 형식은 삭제 가능해야 합니다. |
|
이벤트 처리기를 제대로 선언하십시오. |
|
AssemblyVersionAttribute로 어셈블리 표시 |
|
인터페이스 메서드는 자식 형식에서 호출할 수 있어야 합니다. |
|
네이티브 리소스가 있는 형식은 삭제 가능해야 합니다. |
|
P/Invoke를 NativeMethods 클래스로 이동 |
|
기본 클래스 메서드를 숨기지 마십시오. |
|
IDisposable을 올바르게 구현하십시오. |
|
예기치 않은 위치에서 예외를 발생시키지 마십시오. |
|
중복 액셀러레이터 키를 사용하지 마십시오. |
|
P/Invoke 진입점이 있어야 합니다. |
|
P/Invoke는 노출되지 않아야 합니다. |
|
자동 레이아웃 형식은 COM 노출이면 안 됩니다. |
|
P/Invoke 다음에 바로 GetLastError를 호출하십시오. |
|
COM 노출 형식의 기본 형식은 COM 노출이어야 합니다. |
|
COM 등록 메서드는 일치해야 합니다. |
|
P/Invoke를 올바르게 선언하십시오. |
|
빈 종료자를 제거하십시오. |
|
값 형식 필드는 이식 가능해야 합니다. |
|
P/Invoke 선언은 이식 가능해야 합니다. |
|
약한 ID를 가진 개체를 잠그지 마십시오. |
|
보안상 취약한 부분이 있는지 SQL 쿼리를 검토하십시오. |
|
P/Invoke 문자열 인수에 대해 마샬링을 지정하십시오. |
|
값 형식에서 선언적 보안을 검토하십시오. |
|
포인터는 노출되면 안 됩니다. |
|
보안 형식은 필드를 노출하면 안 됩니다. |
|
메서드 보안은 형식의 상위 집합이어야 합니다. |
|
APTCA 메서드는 APTCA 메서드만 호출해야 합니다. |
|
APTCA 형식은 APTCA 기본 형식만 확장해야 합니다. |
|
링크 요청이 있는 메서드를 간접적으로 노출하지 마십시오. |
|
재정의 링크 요청은 기본 형식의 링크 요청과 같아야 합니다. |
|
취약한 finally 절을 외부 try에 래핑하십시오. |
|
형식 링크 요청에는 상속 요청이 필요합니다. |
|
보안에 중요한 형식은 형식 등가에 참여할 수 없습니다. |
|
기본 생성자는 기본 형식의 기본 생성자 이상으로 중요해야 합니다. |
|
대리인은 투명도가 일관된 메서드에 바인딩해야 합니다. |
|
메서드는 기본 메서드를 재정의할 때 일관성 있는 방식을 유지해야 합니다. |
|
투명한 메서드는 안정형 IL만 포함해야 합니다. |
|
투명한 메서드는 SuppressUnmanagedCodeSecurity 특성을 가진 메서드를 호출해서는 안 됩니다. |
|
투명 코드는 보안에 중요한 항목을 참조해서는 안 됩니다. |
|
투명한 메서드는 LinkDemands를 충족해서는 안 됩니다 |
|
형식은 기본 형식 및 인터페이스 이상으로 중요해야 합니다. |
|
투명 메서드는 보안 어설션을 사용할 수 없습니다. |
|
투명한 메서드는 네이티브 코드를 호출해서는 안 됩니다. |
|
스택 정보를 유지하도록 다시 throw하십시오. |
|
개체를 여러 번 삭제하지 마십시오. |
|
값 형식 정적 필드를 인라인으로 초기화하십시오. |
|
서비스 구성 요소를 WebMethod를 사용하여 표시하지 마십시오. |
|
삭제 가능한 필드는 삭제해야 합니다. |
|
재정의 가능한 메서드를 생성자에서 호출하지 마십시오. |
|
삭제 가능한 형식은 종료자를 선언해야 합니다. |
|
종료자는 기본 클래스 종료자를 호출해야 합니다. |
|
serialization 생성자를 구현하십시오. |
|
ValueType.Equals를 재정의할 때 같음 연산자를 오버로드하십시오. |
|
Windows Forms 진입점을 STAThread를 사용하여 표시하십시오. |
|
모두 serialize할 수 없는 필드로 표시하십시오. |
|
ISerializable 형식에서 기본 클래스 메서드를 호출하십시오. |
|
ISerializable 형식을 SerializableAttribute로 표시하십시오. |
|
serialization 메서드를 올바르게 구현하십시오. |
|
ISerializable을 올바르게 구현하십시오. |
|
형식 메서드에 올바른 인수를 제공하십시오. |
|
NaN에 대해 정확하게 테스트하십시오. |
|
정적 멤버를 제네릭 형식으로 선언하지 마십시오. |
|
제네릭 목록을 노출하지 마십시오. |
|
제네릭 이벤트 처리기 인스턴스를 사용하십시오. |
|
제네릭 메서드는 형식 매개 변수를 제공해야 합니다. |
|
제네릭 형식에 매개 변수를 너무 많이 사용하지 마십시오. |
|
멤버 시그니처에 제네릭 형식을 중첩하지 마십시오. |
|
적합한 제네릭을 사용하십시오. |
|
열거형에는 0 값이 있어야 합니다. |
|
컬렉션은 제네릭 인터페이스를 구현해야 합니다. |
|
기본 형식을 매개 변수로 전달해 보십시오. |
|
추상 형식에는 생성자를 사용하면 안 됩니다. |
|
더하기 및 빼기를 오버로드할 때 같음 연산자를 오버로드하십시오. |
|
CLSCompliantAttribute로 어셈블리 표시 |
|
ComVisibleAttribute로 어셈블리 표시 |
|
특성을 AttributeUsageAttribute로 표시하십시오. |
|
특성 인수의 접근자를 정의하십시오. |
|
다차원 인덱서는 사용하지 마십시오. |
|
적합한 속성을 사용하십시오. |
|
반복 인수를 매개 변수 배열로 바꾸십시오. |
|
기본 매개 변수를 사용하면 안 됩니다. |
|
열거형을 FlagsAttribute로 표시하십시오. |
|
열거형 저장소는 Int32여야 합니다. |
|
적절한 경우 이벤트를 사용하십시오. |
|
일반적인 예외 형식을 catch하지 마십시오. |
|
표준 예외 생성자를 구현하십시오. |
|
중첩 형식은 노출하지 마십시오. |
|
ICollection 구현에 강력한 형식의 멤버가 있습니다. |
|
비교 가능한 형식에 메서드를 재정의하십시오. |
|
열거자는 강력한 형식이어야 합니다. |
|
목록은 강력한 형식이어야 합니다. |
|
ObsoleteAttribute 메시지를 제공하십시오. |
|
인덱서에 정수 또는 문자열 인수를 사용하십시오. |
|
속성은 쓰기 전용이면 안 됩니다. |
|
참조 형식에 같음 연산자를 오버로드하지 마십시오. |
|
protected 멤버를 sealed 형식으로 선언하지 마십시오. |
|
가상 멤버를 sealed 형식으로 선언하지 마십시오. |
|
네임스페이스에 형식을 선언하십시오. |
|
표시되는 인스턴스 필드를 선언하지 마십시오. |
|
정적 소유자 형식은 sealed여야 합니다. |
|
정적 소유자 형식에는 생성자를 사용하면 안 됩니다. |
|
URI 매개 변수는 문자열이면 안 됩니다. |
|
URI 반환 값은 문자열이면 안 됩니다. |
|
URI 속성은 문자열이면 안 됩니다. |
|
문자열 URI 오버로드는 System.Uri 오버로드를 호출합니다. |
|
형식은 특정 기본 형식을 확장하면 안 됩니다. |
|
멤버는 구체적인 특정 형식을 노출하면 안 됩니다. |
|
예외는 public이어야 합니다. |
|
변수 이름은 필드 이름과 달라야 합니다. |
|
지나치게 복잡하게 만들지 마십시오. |
|
식별자에는 대/소문자만 다른 이름을 사용할 수 없습니다. |
|
식별자는 키워드와 달라야 합니다. |
|
사용되지 않은 매개 변수를 검토하십시오. |
|
사용되지 않는 로컬 항목을 제거하십시오. |
|
불필요한 로컬 항목을 사용하지 마십시오. |
|
참조 형식 정적 필드를 인라인으로 초기화하십시오. |
|
호출되지 않는 전용 코드를 사용하지 마십시오. |
|
인스턴스화되지 않은 내부 클래스를 사용하지 마십시오. |
|
봉인되지 않은 특성을 사용하지 마십시오. |
|
다차원 배열보다 가변 배열을 사용하십시오. |
|
값 형식에서 Equals 또는 같음 연산자를 재정의하십시오. |
|
속성은 배열을 반환해서는 안 됩니다. |
|
문자열 길이를 사용하여 문자열이 비었는지 테스트하십시오. |
|
멤버를 static으로 표시하십시오. |
|
사용되지 않는 전용 필드를 사용하지 마십시오. |
|
예약된 예외 형식을 발생시키지 마십시오. |
|
Win32 API에 있는 동일한 기능의 관리되는 항목을 사용하십시오. |
|
인수 예외를 올바르게 인스턴스화하십시오. |
|
비상수 필드는 노출되면 안 됩니다. |
|
열거형을 FlagsAttribute로 표시하지 마십시오. |
|
exception 절에서 예외를 발생시키지 마십시오. |
|
종료자는 protected여야 합니다. |
|
상속된 멤버 노출 수준을 낮추지 마십시오. |
|
멤버는 반환 형식 이외의 것도 달라야 합니다. |
|
같음 연산자를 오버로드할 때 Equals를 재정의하십시오. |
|
연산자 오버로드에는 명명된 대체 항목이 있습니다. |
|
연산자에는 대칭 오버로드가 있어야 합니다. |
|
컬렉션 속성은 읽기 전용이어야 합니다. |
|
가변 인수로 params를 사용하십시오. |
|
문자열 대신 System.Uri 개체를 전달하십시오. |
|
선택적 필드에 deserialization 메서드를 제공하십시오. |