Identifiers should not have incorrect suffix

TypeName	IdentifiersShouldNotHaveIncorrectSuffix
CheckId	CA1711
Category	Microsoft.Naming
Breaking Change	Breaking

Cause

An identifier has an incorrect suffix.

Rule Description

By convention, only the names of types that extend certain base types or that implement certain interfaces, or types derived from these types, should end with specific reserved suffixes. Other type names should not use these reserved suffixes.

The following table lists the reserved suffixes and the base types and interfaces they are associated with.

---

Suffix	Base type/Interface
Attribute	System.Attribute
Collection	System.Collections.ICollection System.Collections.IEnumerable System.Collections.Queue System.Collections.Stack System.Collections.Generic.ICollection System.Data.DataSet System.Data.DataTable
Dictionary	System.Collections.IDictionary System.Collections.Generic.IDictionary
EventArgs	System.EventArgs
EventHandler	An event-handler delegate.
Exception	System.Exception
Permission	System.Security.IPermission
Queue	System.Collections.Queue
Stack	System.Collections.Stack
Stream	System.IO.Stream

In addition, the following suffixes should not be used:

• Delegate

• Enum

• Flags for an enumeration

• Impl

Naming conventions provide a common look for libraries that target the common language runtime. This reduces the learning curve required for new software libraries, and increases customer confidence that the library was developed by someone with expertise in developing managed code.

How to Fix Violations

Remove the suffix from the type name.

When to Exclude Warnings

Do not exclude a warning from this rule.

Related Rules

Identifiers should have correct suffix

See Also

Reference

Attribute Usage Guidelines

Concepts

Events and Delegates