CA1014: CLSCompliantAttribute로 어셈블리 표시

  • 아티클
속성 값
규칙 ID CA1014
타이틀 CLSCompliantAttribute로 어셈블리를 표시하세요.
범주 디자인
수정 사항이 주요 변경인지 여부 주요 변경 아님
.NET 8에서 기본적으로 사용 아니요

원인

어셈블리는 적용된 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

참고 항목