CA1813: 봉인되지 않은 특성을 사용하지 마십시오.
속성 | 값 |
---|---|
규칙 ID | CA1813 |
타이틀 | 봉인되지 않은 특성을 사용하지 마세요. |
범주 | 성능 |
수정 사항이 주요 변경인지 여부 | 주요 변경 |
.NET 8에서 기본적으로 사용 | 아니요 |
원인
public 형식이 System.Attribute에서 상속되며 추상 형식이 아니고 봉인되지 않았습니다(Visual Basic의 경우 NotInheritable
).
규칙 설명
.NET은 사용자 지정 특성을 검색하는 메서드를 제공합니다. 기본적으로 이러한 메서드는 특성 상속 계층을 검색합니다. 예를 들어 System.Attribute.GetCustomAttribute는 지정된 특성 형식 또는 지정된 특성 형식을 확장하는 특성 형식을 검색합니다. 특성을 봉인하면 상속 계층 구조를 통해 검색되지 않으므로 성능이 향상됩니다.
위반 문제를 해결하는 방법
이 규칙의 위반 문제를 해결하려면 특성 형식을 봉인하거나 추상으로 설정합니다.
경고를 표시하지 않는 경우
이 규칙의 경고를 표시하지 않아도 됩니다. 특성 계층 구조를 정의하고 있고 특성을 봉인하거나 추상으로 설정할 수 없는 경우에만 표시하지 않습니다.
경고 표시 안 함
단일 위반만 표시하지 않으려면 원본 파일에 전처리기 지시문을 추가하여 규칙을 사용하지 않도록 설정한 후 다시 사용하도록 설정합니다.
#pragma warning disable CA1813
// The code that's violating the rule is on this line.
#pragma warning restore CA1813
파일, 폴더 또는 프로젝트에 대한 규칙을 사용하지 않도록 설정하려면 구성 파일에서 심각도를 none
으로 설정합니다.
[*.{cs,vb}]
dotnet_diagnostic.CA1813.severity = none
자세한 내용은 방법: 코드 분석 경고 표시 안 함을 참조하세요.
예시
다음 예제에서는 이 규칙을 충족하는 사용자 지정 특성을 보여 줍니다.
// Satisfies rule: AvoidUnsealedAttributes.
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Struct)]
public sealed class DeveloperAttribute : Attribute
{
private string nameValue;
public DeveloperAttribute(string name)
{
nameValue = name;
}
public string Name
{
get
{
return nameValue;
}
}
}
Imports System
Namespace ca1813
' Satisfies rule: AvoidUnsealedAttributes.
<AttributeUsage(AttributeTargets.Class Or AttributeTargets.Struct)>
Public NotInheritable Class DeveloperAttribute
Inherits Attribute
Public Sub New(name As String)
Me.Name = name
End Sub
Public ReadOnly Property Name() As String
End Class
End Namespace
관련 규칙
참고 항목
.NET
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기