缩写词的C#命名约定

Question

关于缩写词的C#命名，如果我正在编写一个与Windows API相关的库，是否有针对WindowsApi或WindowsAPI的强大约定，或者这只是个人偏好？

Answer 1

有一个约定，它为所有长度超过2个字符的首字母缩写指定首字母大写，其余为小写。因此有了HttpContext和ClientID。

Answer 2

"Framework Design Guidelines“第二版，作者: Krzysztof Cwalina和Brad艾布拉姆斯，第40-42页

3.1.2首字母大写

DO将这两个字符大写为两个字符的首字母缩写，但采用驼峰式大小写的标识符的第一个单词除外。

System.IO
public void StartIO(Stream ioStream)

DO只将具有三个或更多字符的首字母缩写词的第一个字符大写，使用驼峰大小写的标识符的第一个单词除外。

System.Xml
public void ProcessHtmlTag(string htmlTag)

在使用驼峰大小写的标识符的开头，不要将任何首字母缩写的字符大写，无论其长度如何。

Answer 3

在Naming Guidelines & Capitalization Conventions上查看微软官方文档

要区分标识符中的单词，请将标识符中每个单词的第一个字母大写。不要使用下划线来区分单词，也不要使用标识符中的任何位置。有两种适当的方法来大写标识符，具体取决于标识符的使用：

• PascalCasing
• camelCasing

PascalCasing约定用于除参数名称之外的所有标识符，它将每个单词的第一个字符大写(包括长度超过两个字母的首字母缩写)，如以下示例所示：

• PropertyDescriptor
• HtmlTag

对于其中两个字母都大写的双字母首字母缩写是一个特例，如以下标识符所示：

• IOStream

仅用于参数名称的camelCasing约定将每个单词的第一个字符大写，第一个单词除外，如下面的示例所示。正如该示例所示，以驼峰大小写的标识符开头的两个字母的缩写都是小写的。

• propertyDescriptor
• ioStream
• htmlTag

对于由多个单词组成的所有公共成员、类型和命名空间名称，DO PascalCasing✓。

对于参数名称，DO camelCasing✓。