2010年11月4日木曜日

Microsoftの名前付けに関するガイドライン

大文字と小文字のスタイル


Pascal 形式
識別子の最初の文字と、後に続いて連結されている各単語の最初の文字を大文字にする。
例   BackColor

Camel 形式
識別子の最初の文字は小文字にし、後に続いて連結されている各単語の最初の文字を大文字にする。
 例  backColor


大文字
識別子のすべての文字を大文字にする。
例 IO



頭字語は使用可

頭字語とは、用語やフレーズに含まれる単語の頭文字から形成される単語。識別子に頭字語を含めるのは、その頭字語が広く知られ、十分理解されている場合のみ。(判断基準はない?)
例   HTML    (Hypertext Markup Language の頭字語)

2 文字から成る頭字語の文字は共に大文字(小文字)にする。
例  IOChannel (ioChannel )

3 文字以上の文字から成る頭字語では、先頭の文字のみを大文字(小文字)にする。
例  XmlWriter  (xmlWriter)




省略形は原則使用不可
一語を短縮した単語。ID(identifier の省略形)、OKは使用可

例    Flg   (Flagの省略形) 
        Msg   (Messageの省略形)

一語として記述される閉じた形式の複合語の各単語は大文字にしない。
判断基準はない?
例   Endpoint   (endpoint)    
       Hashtable   (hashtable)



閉じた形式ではない一般用語
BitFlag (bitFlag)
FileName (fileName)
LogOff (logOff)
LogOn (logOn)
SignIn (signIn)
SignOut (signOut)
UserName (userName)
WhiteSpace (whiteSpace)



派生クラスの名前は、末尾に基本クラスの名前を付ける。


ブール型のプロパティの名前には、肯定的なフレーズにする。
例    ×    CantSeek
        ○   CanSeek
 
ブール型のプロパティには、Is、Can、Has などのプリフィックスを付けてもよい。 

名前に関するガイドライン
ハンガリアン記法

0 件のコメント:

コメントを投稿