Use preferred terms
TypeName |
UsePreferredTerms |
CheckId |
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. Alternatively, 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 built into the rule and in the Deprecated section of any custom dictionaries. The following table shows the terms 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 |
Hasn’t |
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 intentionally and relates specifically to the original term, as opposed to the preferred term.