CA2255: ModuleInitializer 라이브러리에서 특성을 사용하면 안 됩니다.
| 속성 | 값 |
|---|---|
| 규칙 ID | CA2255 |
| 타이틀 | ModuleInitializer 특성을 라이브러리에서 사용해서는 안 됨 |
| 범주 | 사용 현황 |
| 수정 사항이 주요 변경인지 여부 | 주요 변경 아님 |
| .NET 8에서 기본적으로 사용 | 경고로 |
원인
클래스 라이브러리 내의 메서드에 ModuleInitializerAttribute를 적용했습니다.
규칙 설명
모듈 이니셜라이저는 애플리케이션 코드가 실행되기 전에 애플리케이션의 구성 요소가 초기화되도록 하기 위해 애플리케이션 코드에서 사용됩니다. 라이브러리 코드가 ModuleInitializerAttribute를 사용하여 메서드를 선언하는 경우 애플리케이션 초기화를 방해할 수 있으며 해당 애플리케이션의 트리밍 기능에 제한이 발생할 수도 있습니다. 따라서 라이브러리 코드에서 ModuleInitializerAttribute 특성을 사용해서는 안 됩니다.
위반 문제를 해결하는 방법
라이브러리는 표시된 ModuleInitializerAttribute메서드를 사용하는 대신 라이브러리 내의 구성 요소를 초기화하고 애플리케이션이 애플리케이션 초기화 중에 메서드를 호출할 수 있도록 하는 데 사용할 수 있는 메서드를 노출해야 합니다.
경고를 표시하지 않는 경우
솔루션에서 코드 팩터링 목적으로 클래스 라이브러리를 사용하고 ModuleInitializerAttribute 메서드가 공유 또는 분산 라이브러리나 패키지의 일부가 아닌 경우에는 이 규칙의 경고를 표시하지 않는 것이 안전합니다.
경고 표시 안 함
단일 위반만 표시하지 않으려면 원본 파일에 전처리기 지시문을 추가하여 규칙을 사용하지 않도록 설정한 후 다시 사용하도록 설정합니다.
#pragma warning disable CA2255
// The code that's violating the rule is on this line.
#pragma warning restore CA2255
파일, 폴더 또는 프로젝트에 대한 규칙을 사용하지 않도록 설정하려면 구성 파일에서 심각도를 none으로 설정합니다.
[*.{cs,vb}]
dotnet_diagnostic.CA2255.severity = none
이 전체 규칙 범주를 사용하지 않도록 설정하려면 구성 파일에서 범주의 심각도를 none으로 설정합니다.
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Usage.severity = none
자세한 내용은 방법: 코드 분석 경고 표시 안 함을 참조하세요.
참고 항목
.NET