규칙 범주

아티클
03/07/2024

각 코드 분석 규칙은 규칙 범주에 속합니다. 예를 들어 디자인 규칙은 .NET 디자인 지침을 준수하도록 지원하며 보안 규칙은 보안 결함을 방지하는 데 도움이 됩니다. 규칙의 전체 범주에 대해 심각도 수준을 구성할 수 있습니다. 범주별로 추가 옵션을 구성할 수도 있습니다.

다음 표에서는 다양한 코드 분석 규칙 범주를 보여 주고 각 범주에 있는 규칙의 링크를 제공합니다. 또한 범주별로 규칙 심각도를 일괄 구성하기 위해 EditorConfig 파일에서 사용할 구성 값을 나열합니다. 예를 들어 보안 규칙 위반의 심각도가 오류가 되도록 설정하려면 EditorConfig 항목은 dotnet_analyzer_diagnostic.category-Security.severity = error가 됩니다.

팁

dotnet_analyzer_diagnostic.category-<category>.severity 구문을 사용한 규칙 범주 심각성 설정은 기본적으로 비활성화되는 규칙에는 적용되지 않습니다. 그러나 .NET 6부터 AnalysisMode<Category> 프로젝트 속성을 사용하여 범주의 모든 규칙을 사용하도록 설정할 수 있습니다.

디자인 규칙

	값
규칙 링크	디자인 규칙
설명	디자인 규칙은 Framework 디자인 지침 준수를 지원합니다.
EditorConfig 값	`dotnet_analyzer_diagnostic.category-Design.severity`
MSBuild 속성 값	`<AnalysisModeDesign>`

설명서 규칙

	값
규칙 링크	설명서 규칙
설명	설명서 규칙은 외부에서 볼 수 있는 API에 대해 XML 문서 주석을 올바르게 사용하여 잘 문서화된 라이브러리를 작성하도록 지원합니다.
EditorConfig 값	`dotnet_analyzer_diagnostic.category-Documentation.severity`
MSBuild 속성 값	`<AnalysisModeDocumentation>`

세계화 규칙

	값
규칙 링크	세계화 규칙
설명	세계화 규칙은 전 세계에서 사용할 수 있는 라이브러리 및 애플리케이션을 지원합니다.
EditorConfig 값	`dotnet_analyzer_diagnostic.category-Globalization.severity`
MSBuild 속성 값	`<AnalysisModeGlobalization>`

이식성 및 상호 운용성 규칙

	값
규칙 링크	이식성 및 상호 운용성 규칙
설명	이식성 규칙은 다양한 플랫폼에서 이식성을 지원합니다. 상호 운용성 규칙은 COM 클라이언트와 상호 작용을 지원합니다.
EditorConfig 값	`dotnet_analyzer_diagnostic.category-Interoperability.severity`
MSBuild 속성 값	`<AnalysisModeInteroperability>`

유지 관리 규칙

	값
규칙 링크	유지 관리 규칙
설명	유지 관리 규칙은 라이브러리 및 애플리케이션 유지 관리를 지원합니다.
EditorConfig 값	`dotnet_analyzer_diagnostic.category-Maintainability.severity`
MSBuild 속성 값	`<AnalysisModeMaintainability>`

명명 규칙

	값
규칙 링크	명명 규칙
설명	명명 규칙은 .NET 디자인 지침의 명명 규칙을 준수하도록 지원합니다.
EditorConfig 값	`dotnet_analyzer_diagnostic.category-Naming.severity`
MSBuild 속성 값	`<AnalysisModeNaming>`

성능 규칙

	값
규칙 링크	성능 규칙
설명	성능 규칙은 고성능 라이브러리 및 애플리케이션을 지원합니다.
EditorConfig 값	`dotnet_analyzer_diagnostic.category-Performance.severity`
MSBuild 속성 값	`<AnalysisModePerformance>`

SingleFile 규칙

	값
규칙 링크	SingleFile 규칙
설명	단일 파일 규칙은 단일 파일 애플리케이션을 지원합니다.
EditorConfig 값	`dotnet_analyzer_diagnostic.category-SingleFile.severity`
MSBuild 속성 값	`<AnalysisModeSingleFile>`

안정성 규칙

	값
규칙 링크	안정성 규칙
설명	안정성 규칙은 올바른 메모리 및 스레드 사용과 같은 라이브러리 및 애플리케이션 안정성을 지원합니다.
EditorConfig 값	`dotnet_analyzer_diagnostic.category-Reliability.severity`
MSBuild 속성 값	`<AnalysisModeReliability>`

보안 규칙

	값
규칙 링크	보안 규칙
설명	보안 규칙은 더 안전한 라이브러리 및 애플리케이션을 지원합니다. 해당 규칙을 통해 프로그램에서 보안 결함을 방지할 수 있습니다.
EditorConfig 값	`dotnet_analyzer_diagnostic.category-Security.severity`
MSBuild 속성 값	`<AnalysisModeSecurity>`

스타일 규칙

	값
규칙 링크	스타일 규칙
설명	스타일 규칙은 코드베이스에서 일관된 코드 스타일을 지원합니다. 이러한 규칙은 "IDE" 접두사로 시작합니다.^*
EditorConfig 값	`dotnet_analyzer_diagnostic.category-Style.severity`
MSBuild 속성 값	`<AnalysisModeStyle>`

* EditorConfig 값 dotnet_analyzer_diagnostic.category-CodeQuality.severity(을)를 사용하여 IDE0051, IDE0052, IDE0064 및 IDE0076 규칙을 사용하도록 설정합니다. 이러한 규칙은 "IDE"로 시작하지만 기술적으로 Style 범주에 속하지는 않습니다.

사용 규칙

	값
규칙 링크	사용 규칙
설명	사용 규칙은 .NET의 적절한 사용을 지원합니다.
EditorConfig 값	`dotnet_analyzer_diagnostic.category-Usage.severity`
MSBuild 속성 값	`<AnalysisModeUsage>`

다음을 통해 공유