Skip to main content

How to Resolve Error "CS0698: A generic type cannot derive from 'Attribute' because it is an attribute class" in C#

The Compiler Error CS0698 is a language restriction error that occurs in versions of C# prior to C# 11. The message reads: "A generic type cannot derive from 'Attribute' because it is an attribute class".

Attributes in .NET ([MyAttribute]) are compiled into metadata stored within the assembly. Historically, the C# compiler and the language specification did not support defining Attributes that used Generics (e.g., MyAttribute<T>). While the underlying Runtime (CLR) technically supported it, the C# language forbade it until the release of C# 11 (.NET 7).

This guide explains how to fix this error by either upgrading your language version or using the standard typeof pattern for older environments.

Understanding Generic Attributes​

The goal of a generic attribute is to allow cleaner syntax when tagging classes.

  • Desired Syntax (Generic): [TypeConverter<MyConverter>]
  • Legacy Syntax (Non-Generic): [TypeConverter(typeof(MyConverter))]

If you attempt to define the "Desired" generic class in C# 10 or older, the compiler raises CS0698 because the language feature does not exist in that version.

Scenario: Defining a Generic Attribute in Older C#​

You try to create a custom attribute that accepts a type parameter T.

Example of error:

using System;

// ⛔️ Error CS0698: A generic type cannot derive from 'Attribute' 
// because it is an attribute class.
public class ValidatorAttribute<T> : Attribute
{
    public T DefaultValue { get; set; }
}

This definition implies you want to use it like [Validator<int>] or [Validator<string>]. In C# 10 and below, this is illegal.

If you are using .NET 7 or newer, you can resolve this error simply by updating your project's language version. Generic attributes are a fully supported feature in C# 11.

Step 1: Check your .csproj​

Ensure your project targets a modern framework and language version.

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <!-- Target .NET 7 or later -->
    <TargetFramework>net7.0</TargetFramework>
    
    <!-- Or explicitly set LangVersion to 11 or 'latest' -->
    <LangVersion>11</LangVersion>
  </PropertyGroup>
</Project>

Step 2: Compile​

With C# 11 enabled, the exact code that previously failed will now compile successfully.

// ✅ Correct (in C# 11+):
public class ValidatorAttribute<T> : Attribute { }

[Validator<int>]
public class DataProcessor { }
note

If you are stuck on .NET Framework or an older .NET Core version (like 3.1), you cannot use C# 11 features that rely on newer runtime support. Use Solution 2.

Solution 2: Use the typeof Pattern (Legacy Support)​

If you cannot upgrade to C# 11, you must use the standard pattern that C# has used for 20 years: passing the Type as a constructor argument rather than a generic parameter.

Solution: change the class to be non-generic and accept a System.Type parameter in the constructor.

using System;

// ✅ Correct: Non-generic class inheriting from Attribute
public class ValidatorAttribute : Attribute
{
    public Type ValidType { get; }

    // Pass the type via constructor
    public ValidatorAttribute(Type type)
    {
        ValidType = type;
    }
}

// Usage syntax changes slightly:
[Validator(typeof(int))]
public class DataProcessor 
{ 
}

This pattern is used extensively in the .NET Framework (e.g., [ServiceKnownType(typeof(MyType))]).

Conclusion​

CS0698 is a version compatibility error.

  1. Check Version: Are you on .NET 7+? Update your <LangVersion> to 11 or latest.
  2. Legacy Projects: If you must support older environments, remove the <T> from the class definition.
  3. Refactor: Replace the generic parameter with a Type property and pass the value using typeof(MyType) in the constructor.

Table of Contents