Click to Rate and Give Feedback
MSDN
MSDN Library
Visual Studio 2005
Naming Warnings
 Long acronyms should be pascal-case...
Collapse All/Expand All Collapse All
Visual Studio Team System
Long acronyms should be pascal-cased

TypeName

LongAcronymsShouldBePascalCased

CheckId

CA1705

Category

Microsoft.Naming

Breaking Change

Breaking

The name of an identifier contains an acronym of three or more uppercase letters.

This rule assumes it has found an acronym when the name contains four uppercase letters in a row, or at the end of the name, three uppercase letters in a row.

By convention, two-letter acronyms use all uppercase letters, and acronyms of three or more characters use Pascal casing. The following examples conform to this naming convention: 'DB', 'CR', 'Cpa', and 'Ecma'. The following examples violate the convention: 'Io', 'XML', and 'DoD', and for non-parameter names, 'xp' and 'cpl'.

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.

Change any three-letter acronyms in the name to Pascal case, and change any two-letter acronyms to uppercase.

Do not exclude a warning from this rule.

Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
More Information      David M. Kean - MSFT   |   Edit   |   Show History

For more information on the guidelines this rule enforces, see the following external resources:

Capitalization Conventions, Design Guidelines for Developing Class Libraries
http://msdn2.microsoft.com/en-us/library/ms229043.aspx

Page 36, Framework Design Guidelines: Conventions, Idioms and Patterns for Reusable .NET Libraries
Krzysztof Cwalina and Brad Abrams
http://www.amazon.com/gp/product/0321246756/002-6248839-4752853?v=glance&n=283155

Tags What's this?: Add a tag
Flag as ContentBug
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use | Trademarks | Privacy Statement | Site Feedback
Page view tracker