注
このコンテンツは、 フレームワーク設計ガイドライン (再利用可能な .NET ライブラリの規則、イディオム、パターン、第 2 版) から、Pearson Education, Inc. のアクセス許可によって再印刷されます。 そのエディションは2008年に出版され、その後 、本は第3版で完全に改訂されています。 このページの情報の一部が古くなっている可能性があります。
この章のガイドラインでは、一貫して適用すると、型、メンバー、およびパラメーターの識別子を読みやすくするケースを使用するための簡単な方法を示します。
識別子の大文字と小文字の規則
識別子内の単語を区別するには、識別子内の各単語の最初の文字を大文字にします。 アンダースコアを使用して単語を区別したり、識別子内の任意の場所で区別したりしないでください。 識別子の使用に応じて、識別子を大文字にする適切な方法は 2 つあります。
PascalCasing
camelCasing
パラメーター名を除くすべての識別子に使用される PascalCasing 規則では、次の例に示すように、各単語の最初の文字 (長さが 2 文字以上の頭字語を含む) が大文字になります。
PropertyDescriptor
HtmlTag
次の識別子に示すように、両方の文字が大文字の 2 文字の頭字語に対して特殊なケースが作成されます。
IOStream
次の例に示すように、camelCasing 規則は、パラメーター名にのみ使用され、最初の単語を除く各単語の最初の文字を大文字にします。 この例でも示すように、キャメルケース識別子を開始する 2 文字の頭字語は両方とも小文字です。
propertyDescriptor
ioStream
htmlTag
✔️ 複数の単語で構成されるすべてのパブリック メンバー、型、および名前空間名に PascalCasing を使用してください。
✔️ パラメーター名には camelCasing を使用してください。
次の表では、さまざまな種類の識別子の大文字と小文字の表記規則について説明します。
| 識別子 | 大文字小文字の区別 | 例 |
|---|---|---|
| Namespace | パスカル | namespace System.Security { ... } |
| タイプ | パスカル | public class StreamReader { ... } |
| インターフェイス | パスカル | public interface IEnumerable { ... } |
| メソッド | パスカル | public class Object { public virtual string ToString(); } |
| プロパティ | パスカル | public class String { public int Length { get; } } |
| 出来事 | パスカル | public class Process { public event EventHandler Exited; } |
| フィールド | パスカル | public class MessageQueue { public static readonly TimeSpan InfiniteTimeout; } public struct UInt32 { public const Min = 0; } |
| 列挙値 | パスカル | public enum FileMode { Append, ... } |
| パラメーター | 駱駝 | public class Convert { public static int ToInt32(string value); } |
複合語と一般的な用語の大文字化
ほとんどの複合用語は、大文字化の目的で単一の単語として扱われます。
❌ 各単語を、いわゆる閉じた形式の複合語で大文字にしないでください。
エンドポイントなど、単一の単語として記述された複合語です。 大文字と小文字の区別のガイドラインでは、閉じた形式の複合語を 1 つの単語として扱います。 現在の辞書を使用して、複合語が閉じた形式で書き込まれるかどうかを判断します。
| パスカル | 駱駝 | じゃない |
|---|---|---|
BitFlag |
bitFlag |
Bitflag |
Callback |
callback |
CallBack |
Canceled |
canceled |
Cancelled |
DoNot |
doNot |
Don't |
Email |
email |
EMail |
Endpoint |
endpoint |
EndPoint |
FileName |
fileName |
Filename |
Gridline |
gridline |
GridLine |
Hashtable |
hashtable |
HashTable |
Id |
id |
ID |
Indexes |
indexes |
Indices |
LogOff |
logOff |
LogOut |
LogOn |
logOn |
LogIn |
Metadata |
metadata |
MetaData, metaData |
Multipanel |
multipanel |
MultiPanel |
Multiview |
multiview |
MultiView |
Namespace |
namespace |
NameSpace |
Ok |
ok |
OK |
Pi |
pi |
PI |
Placeholder |
placeholder |
PlaceHolder |
SignIn |
signIn |
SignOn |
SignOut |
signOut |
SignOff |
UserName |
userName |
Username |
WhiteSpace |
whiteSpace |
Whitespace |
Writable |
writable |
Writeable |
大文字と小文字の区別
CLR で実行できる言語は、大文字と小文字の区別をサポートするために必要ありませんが、サポートする言語もあります。 言語でサポートされている場合でも、フレームワークにアクセスする可能性のある他の言語ではサポートされません。 そのため、外部からアクセス可能な API は、大文字と小文字を区別するだけでは、同じコンテキスト内の 2 つの名前を区別することはできません。
❌ すべてのプログラミング言語で大文字と小文字が区別されるとは想定しないでください。 これらはありません。 名前は大文字と小文字のみでは異なることはできません。
Portions © 2005, 2009 Microsoft Corporation. 無断転載を禁じます。
フレームワーク設計ガイドライン:再利用可能な .NET ライブラリの規則、イディオム、パターン、Krzysztof Cwalina および Brad Abrams による第 2 版は、2008 年 10 月 22 日に Microsoft Windows 開発シリーズの一部として Addison-Wesley Professional によって公開されました。