• 09 «
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • » 11
ASOK?
ActionScriptでFlashつくるよ
上記の広告は1ヶ月以上更新のないブログに表示されています。
新しい記事を書く事で広告が消せます。
page top

2009-08-17 - 当面C#と.NETな記録

この記事をきっかけに、.NETの設計をちょっと調べてみた。

命名について

  • .NET ではメソッド名は ToString のように Pascal 形式で名前を付けます
  • パラメータ名などには typeName のように Camel 形式を使います

表記について、msdnでよいまとめを発見。

大文字の使用規則

Pascal 形式

識別子の最初の文字と、後に続いて連結されている各単語の最初の文字を大文字にします。Pascal 形式は、3 文字以上から構成される識別子に対して使用できます。次に例を示します。

BackColor

Camel 形式

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

backColor

大文字

識別子のすべての文字を大文字にします。この例を次に示します。

IO

さらに頭字語(HTML、XMLなど)を使用する場合

Camel 形式の識別子の先頭の単語を除き、2 文字から成る頭字語の文字は共に大文字にしてください。

DBRate というプロパティは、短い頭字語 (DB) が Pascal 形式の識別子の先頭の文字として使用されている例です。ioChannel というパラメータは、短い頭字語 (IO) が Camel 形式の識別子の先頭の文字として使用されている例です。

Camel 形式の識別子の先頭の単語を除き、3 文字以上の文字から成る頭字語では、先頭の文字のみを大文字にしてください。

XmlWriter というクラスは、長い頭字語が Camel 形式の識別子の先頭の単語として使用されている例です。htmlReader というパラメータは、長い頭字語が Camel 形式の識別子の先頭の単語として使用されている例です。

Camel 形式では、識別子の先頭にある頭字語の文字は、その文字数とは関係なく、一切大文字にはしないでください。

xmlStream というパラメータは、長い頭字語 (xml) が Camel 形式の識別子の先頭の単語として使用されている例です。dbServerName というパラメータは、短い頭字語 (db) が Camel 形式の識別子の先頭の文字として使用されている例です。

なんだかとてもややこしいので、まとめると。

Camel形式の先頭に頭字語が来る場合は大文字にしない
xmlStream, dbServerName, ioChannel, htmlReader

上記を除き、2 文字から成る頭字語は大文字にする。
DBRate

上記を除き、3文字以上の頭字語は先頭のみ大文字に。
XmlWriter

メソッド名のつけ方

  • メソッド名には実装の詳細を使用しないでください
    • how をメソッド名にするな、what をメソッド名にしろってことですね

メソッド名には、動詞または動詞句を割り当ててください。

通常、メソッドはデータを操作するため、メソッドのアクションを表す動詞を使用すると、開発者にはメソッドの機能がよりわかりやすくなります。メソッドが実行するアクションを定義するときは、開発者から見てわかりやすい名前を選択するように注意してください。メソッドがアクションを実行する方法を表す動詞は使用しないでください。言い換えると、メソッド名には実装の詳細を使用しないでください。

型のメンバの名前

TryParse パターン

例外を返す Parse と例外を返さない TryParse という2つのメソッドを用意して、例外によるパフォーマンス低下を回避する

メソッド名のパターン

イベントを発生させるメソッドの接頭辞 OnEventName

非同期パターン接頭辞 Beginなんとか、Endなんとか

関連記事
page top

コメント

管理者にだけ表示を許可する
 

トラックバック
TB*URL
Copyright © 2005 ASOK?. all rights reserved.

上記広告は1ヶ月以上更新のないブログに表示されています。新しい記事を書くことで広告を消せます。