다음을 통해 공유

CA1014: CLSCompliantAttribute로 어셈블리 표시

속성 값
규칙 ID CA1014
제목 CLSCompliantAttribute로 어셈블리를 표시하세요.
범주 디자인
수정 사항이 호환성을 깨뜨리는지 여부 또는 무중단인지 여부 주요 변경 아님
.NET 10에서 기본적으로 사용하도록 설정 아니요
적용 가능한 언어 C# 및 Visual Basic

원인

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

참고하기

  • Last updated on