регистр символов для сокращений в dotnet - PullRequest
2 голосов
/ 03 июля 2011

Задумывались ли вы, почему MS не пишет сокращения в верхнем регистре?Например, Guid, BmpBitmapEncoder, System.Net.Mime, HttpWebRequest, XmlDocument и т. Д. Вместо GUID, BMPBitmapEncoder, System.Net.MIME, HTTPWebRequest, XMLDocument.Я подозреваю, что это для лучшей читабельности, но на мой взгляд, это хуже, и, возможно, даже немного неправильно.Есть ли документ MS, который объясняет, почему они решили сделать это так?Я уверен, что это намеренно, но вот бонусный вопрос, найдите имя в BCL, которое содержит все заглавные буквы:)

Ответы [ 2 ]

5 голосов
/ 03 июля 2011

Правило, которое они используют, состоит в том, что двухбуквенные аббревиатуры оставляются заглавными: IOException

В то время как более длинные аббревиатуры рассматриваются как слова и используют начальную букву.

С http://msdn.microsoft.com/en-us/library/ms229043.aspx:

В следующих рекомендациях указан правильный корпус для коротких и длинных сокращений. Правила размещения идентификаторов имеют приоритет над правилами размещения сокращений.

Используйте заглавные буквы обоих символов двухсимвольных сокращений, кроме первого слова идентификатора в верблюжьей клетке.

Свойство с именем DBRate является примером короткой аббревиатуры (DB), используемой в качестве первого слова идентификатора в Паскале. Параметр с именем ioChannel является примером короткой аббревиатуры (IO), используемой в качестве первого слова идентификатора в верблюжьей клетке.

Прописывать только первый символ аббревиатур с тремя или более символами, кроме первого слова идентификатора в верблюжьей шкуре.

Класс с именем XmlWriter является примером длинной аббревиатуры, используемой в качестве первого слова идентификатора в Паскале. Параметр с именем htmlReader является примером длинной аббревиатуры, используемой в качестве первого слова идентификатора в верблюжьей клетке.

Не пишите с заглавной буквы любые символы любых сокращений, независимо от их длины, в начале идентификатора в верблюжьей клетке.

Параметр с именем xmlStream является примером длинной аббревиатуры (xml), используемой в качестве первого слова идентификатора в верблюжьей клетке. Параметр с именем dbServerName является примером короткой аббревиатуры (дБ), используемой в качестве первого слова идентификатора в верблюжьей клетке.

0 голосов
/ 03 июля 2011

Мне не удалось найти ссылку на , почему это так (но я ожидаю, что читабельность была проблемой).Однако в руководящих указаниях указано, что сокращения, содержащие более 2 букв, должны быть в PascalCased.

"Делать заглавными только первый символ аббревиатур с тремя или более символами, кроме первого слова идентификатора в верблюжьей клетке."

...