Share via


CA1726: Use preferred terms

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

Item Value
RuleId CA1726
Category Microsoft.Naming
Breaking change Breaking - when fired on assemblies

Non-breaking - when fired on type parameters

Cause

The name of an externally visible identifier includes a term for which an alternative, preferred term exists. Or, the name includes the term Flag or Flags.

Rule description

This rule parses an identifier into tokens. Each single token and each contiguous dual token combination is compared to terms that are built into the rule and in the Deprecated section of any custom dictionaries. The following table shows the terms that are built into the rule and their preferred alternatives.

Obsolete term Preferred term
Arent AreNot
Cancelled Canceled
Cant Cannot
ComPlus EnterpriseServices
Couldnt CouldNot
Didnt DidNot
Doesnt DoesNot
Dont DoNot
Flag or Flags There is no replacement term. Do not use.
Hadnt HadNot
Hasnt HasNot
Havent HaveNot
Indices Indexes
Isnt IsNot
LogIn LogOn
LogOut LogOff
Shouldnt ShouldNot
SignOn SignIn
SignOff SignOut
Wasnt WasNot
Werent WereNot
Wont WillNot
Wouldnt WouldNot
Writeable Writable

How to fix violations

To fix a violation of this rule, replace the term with the preferred alternative term.

When to suppress warnings

Suppress a warning from this rule only if the name of the identifier is intentional and relates specifically to the original term instead of the preferred term.

Naming Warnings