CA1017: ComVisibleAttribute로 어셈블리 표시

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

원인

어셈블리는 적용된 System.Runtime.InteropServices.ComVisibleAttribute 특성이 없습니다.

규칙 설명

ComVisibleAttribute 특성은 COM 클라이언트에서 관리 코드에 액세스하는 방식을 결정합니다. 어셈블리에서 COM에 노출할지 여부를 명시적으로 나타내는 것이 좋은 디자인입니다. COM 표시 여부를 전체 어셈블리에 설정하고 개별 형식과 형식 멤버에 재정의할 수 있습니다. 이 특성이 없으면 COM 클라이언트에서 어셈블리의 내용을 볼 수 있습니다.

위반 문제를 해결하는 방법

이 규칙 위반 문제를 해결하려면 어셈블리에 특성을 추가합니다. 어셈블리를 COM 클라이언트에 표시하지 않으려면 특성을 적용하고 해당 값을 false로 설정합니다.

경고를 표시하지 않는 경우

이 규칙에서는 경고를 표시해야 합니다. 어셈블리를 표시하려면 특성을 적용하고 해당 값을 true로 설정합니다.

예시

다음 예제에서는 ComVisibleAttribute 특성이 적용된 어셈블리를 표시하여 COM 클라이언트에 표시되지 않게 합니다.

<Assembly: System.Runtime.InteropServices.ComVisible(False)>
Namespace DesignLibrary
End Namespace

[assembly: System.Runtime.InteropServices.ComVisible(false)]
namespace DesignLibrary {}

참고 항목