CA1813:避免使用非密封特性

值

规则 ID

CA1813

类别

“性能”

修复是中断修复还是非中断修复

重大

原因

继承自 System.Attribute 的公共类型不是抽象类型，也不会密封（Visual Basic 中的 NotInheritable）。

规则说明

.NET 提供用于检索自定义特性的方法。 默认情况下，这些方法搜索特性继承层次结构。 例如，System.Attribute.GetCustomAttribute 搜索指定的特性类型或扩展指定特性类型的所有特性类型。 密封特性后，无需通过继承层次结构进行搜索，且能够提高性能。

如何解决冲突

若要解决此规则的冲突，请密封特性类型或使其成为抽象类型。

何时禁止显示警告

可安全地禁止显示此规则的警告。 仅当你正在定义特性层次结构，并且不能密封特性或使其成为抽象特性时才禁止显示。

示例

下面的示例显示了一个符合此规则的自定义特性。

// 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

相关规则

CA1019:定义特性参数的访问器

CA1018:用 AttributeUsageAttribute 标记特性

请参阅

特性