在C#中如何自定义仅可附加到特定基类派生类的特性？

1. 先修复当前编译错误 #

自定义特性类必须继承System.Attribute，否则无法使用AttributeUsageAttribute。修正后的代码：

[AttributeUsage(AttributeTargets.Class, AllowMultiple = true)]
public class AbilityTemplateAttribute : Attribute
{
}

2. 实现特性仅能附加到特定父类的类上 #

AttributeUsage只能限制特性可应用的成员类型（比如类、方法），但无法约束目标类的父类。要实现你的需求，有两种常用方案：

方案一：运行时验证 #

在读取特性时，检查目标类是否继承自你指定的基类。举个例子，假设你要限制特性只能附加到AbilityBase的子类上：

// 你指定的基类
public abstract class AbilityBase { }

// 已修正继承关系的自定义特性
[AttributeUsage(AttributeTargets.Class, AllowMultiple = true)]
public class AbilityTemplateAttribute : Attribute
{
}

// 用于验证特性合法性的工具类
public static class AttributeChecker
{
    public static IEnumerable<AbilityTemplateAttribute> GetValidTemplates(Type targetType)
    {
        // 检查目标类是否继承自AbilityBase
        if (!typeof(AbilityBase).IsAssignableFrom(targetType))
        {
            throw new InvalidOperationException($"类 {targetType.Name} 未继承自 AbilityBase，无法使用 AbilityTemplateAttribute");
        }
        return targetType.GetCustomAttributes<AbilityTemplateAttribute>(true);
    }
}

后续读取特性时统一通过这个工具类，就能在运行时拦截不符合要求的类。

方案二：编译时强制检查（推荐） #

如果想在编码阶段就报错，避免运行时踩坑，可以使用Roslyn自定义分析器。核心逻辑是编写分析器，在编译时检查带有AbilityTemplateAttribute的类是否继承了指定基类，不符合则抛出编译错误。

简单实现步骤：

• 创建Roslyn分析器项目
• 注册语法分析器，监听类声明节点
• 检查类是否带有AbilityTemplateAttribute
• 若带有该特性，进一步检查类的基类是否为你指定的类型（比如AbilityBase）
• 不符合要求则报告编译错误

核心代码片段示例：

public class AbilityTemplateAnalyzer : DiagnosticAnalyzer
{
    public const string DiagnosticId = "AbilityTemplate001";
    private static readonly LocalizableString Title = "特性仅允许用于AbilityBase的子类";
    private static readonly LocalizableString MessageFormat = "类 '{0}' 未继承自 AbilityBase，无法使用 AbilityTemplateAttribute";
    private static readonly LocalizableString Description = "AbilityTemplateAttribute只能附加到继承自AbilityBase的类上";
    private const string Category = "Usage";

    private static readonly DiagnosticDescriptor Rule = new DiagnosticDescriptor(
        DiagnosticId, Title, MessageFormat, Category, DiagnosticSeverity.Error, isEnabledByDefault: true, description: Description);

    public override ImmutableArray<DiagnosticDescriptor> SupportedDiagnostics => ImmutableArray.Create(Rule);

    public override void Initialize(AnalysisContext context)
    {
        context.ConfigureGeneratedCodeAnalysis(GeneratedCodeAnalysisFlags.None);
        context.EnableConcurrentExecution();
        context.RegisterSymbolAction(AnalyzeSymbol, SymbolKind.NamedType);
    }

    private static void AnalyzeSymbol(SymbolAnalysisContext context)
    {
        var namedTypeSymbol = (INamedTypeSymbol)context.Symbol;
        // 检查类是否带有目标特性
        var hasAttribute = namedTypeSymbol.GetAttributes().Any(attr => 
            attr.AttributeClass?.Name == nameof(AbilityTemplateAttribute));
        
        if (!hasAttribute) return;

        // 检查是否继承自指定基类
        var baseType = namedTypeSymbol.BaseType;
        if (baseType == null || !typeof(AbilityBase).IsAssignableFrom(baseType))
        {
            var diagnostic = Diagnostic.Create(Rule, namedTypeSymbol.Locations[0], namedTypeSymbol.Name);
            context.ReportDiagnostic(diagnostic);
        }
    }
}

这种方式能在编码阶段就给出错误提示，体验更好，但需要额外开发分析器并集成到项目中。

内容的提问来源于stack exchange，提问作者martinrhan