CA1014: CLSCompliantAttribute로 어셈블리 표시
| 속성 | 값 |
|---|---|
| 규칙 ID | CA1014 |
| 제목 | CLSCompliantAttribute로 어셈블리를 표시하세요. |
| 범주 | 디자인 |
| 수정 사항이 주요 변경인지 여부 | 주요 변경 아님 |
| .NET 9에서 기본적으로 사용 | 아니요 |
원인
어셈블리는 적용된 System.CLSCompliantAttribute 특성이 없습니다.
규칙 설명
CLS(공용 언어 사양)는 어셈블리가 여러 프로그래밍 언어에 사용될 경우 준수해야 하는 명명 제한, 데이터 형식 및 규칙을 정의합니다. 모든 어셈블리에는 CLSCompliantAttribute를 사용하여 CLS 규격을 명시적으로 나타내는 것이 좋습니다. 어셈블리에 해당 특성이 없으면 규격을 따르지 않는 어셈블리입니다.
CLS 규격 어셈블리에는 호환되지 않는 형식 또는 형식 멤버가 포함될 수 있습니다.
위반 문제를 해결하는 방법
이 규칙 위반 문제를 해결하려면 어셈블리에 특성을 추가합니다. 전체 어셈블리를 비규격으로 표시하는 대신 호환되지 않는 형식 또는 형식 멤버를 결정하고 이러한 요소를 표시해야 합니다. 가능하면 최대한 폭넓은 대상 사용자가 어셈블리의 모든 기능에 액세스할 수 있도록 비규격 멤버에 대한 CLS 규격 대체 항목을 제공해야 합니다.
경고를 표시하지 않는 경우
이 규칙에서는 경고를 표시해야 합니다. 어셈블리를 규격으로 설정하지 않으려면 특성을 적용하고 해당 값을 false로 설정합니다.
경고 표시 안 함
단일 위반만 표시하지 않으려면 원본 파일에 전처리기 지시문을 추가하여 규칙을 사용하지 않도록 설정한 후 다시 사용하도록 설정합니다.
#pragma warning disable CA1014
// The code that's violating the rule is on this line.
#pragma warning restore CA1014
파일, 폴더 또는 프로젝트에 대한 규칙을 사용하지 않도록 설정하려면 구성 파일에서 심각도를 none으로 설정합니다.
[*.{cs,vb}]
dotnet_diagnostic.CA1014.severity = none
자세한 내용은 방법: 코드 분석 경고 표시 안 함을 참조하세요.
예시
다음 예제에서는 CLS 규격을 선언하는 System.CLSCompliantAttribute 특성이 적용된 어셈블리를 보여 줍니다.
[assembly:CLSCompliant(true)]
namespace DesignLibrary {}
<assembly:CLSCompliant(true)>
Namespace DesignLibrary
End Namespace
참고 항목
.NET