c# - 命名規則: 動詞/名詞および英文法の使用に関するガイドライン

Question

誰か私にサイトを教えてくれませんか? または、オブジェクトやメソッドの機能に関連するインターフェイス、クラス、さらにはメソッドやプロパティの名前をどのように選択するかについて、知恵を貸してくれませんか?

これは特に Microsoft 開発向けであるため、Java 風の「doGet」などは実際には使用されませんが、言語の壁を越える一般的なルールが存在する必要があります (私はそう思っていました)。

例が役立つかもしれません: インターフェイスの名前には 4 つの選択肢があります。

IGroupedItem
IGroupableItem
IDataEntity
IGroupedEntity

それらはすべて、形容詞と名詞、または名詞のみを含んでいます。.NET フレームワークを見ると、一貫性を保つために、これにはある種のルールセットが必要なようです。メソッドの明らかな動詞は別として。

編集:例はインターフェイスですが、これをインターフェイスだけに限定しているわけではありません。一般的なガイドラインは、クラスは名詞、メソッド動詞、プロパティ名詞です。私が言いたいのは同義語の選択だと思います。どこでも間違って「エンティティ」をスローしています

score 21 · Accepted Answer

命名ガイドラインについては、MSDN の記事を参照してください。要するに：

あなたの例では - IGroupableItem.

score 9 · Accepted Answer

インターフェイスは、クラスが実行できるものです。それが何であるかではなく、何ができるかです。

IGroupableItem

他の名前は、物事が何であるか、または漠然としていて役に立たないことを説明しています。

具体的には、「IDataEntity」はほとんど意味がありません。結局のところ、すべてがデータエンティティです。

score 4 · Accepted Answer

MSDN には、 Interface Naming Guidelines に関する記事があり、参考になるかもしれません。インターフェイス以外の命名規則や、その他の多くの命名および設計ガイドラインが必要な場合は、MSDN でもすべて見つけることができます。

score 1 · Accepted Answer

これはSpodiの回答と同じ資料ですが、MSDNのクラスライブラリ開発者向けの設計ガイドラインは、ほとんどの場合優れており、名前付けなどを網羅しています。

score 1 · Accepted Answer

JoelSpolskyによる「間違ったコードを間違って見えるようにする」という素晴らしい記事があります。それほど人気はありませんが、非常に便利な命名規則について説明しています。

score 1 · Accepted Answer

MSDN ガイドラインと同様に、 Juval Lowy による IDesignの C# コーディング標準ドキュメントが非常に役立ちます (これが MSDN とどの程度異なるかはわかりません)。

score 0 · Accepted Answer

関数 (およびその他) の名前の動詞については、動詞の元の形を使用するのが一般Handle的ExecuteQueryですIsAny。

あまり一般的ではない動詞の使用法ではs/es、 , like ProducesResponseType( MS Docs ) で単数形になります。

score -1 · Accepted Answer

これを試して....

メインサイト：http
：//www.ssw.com.au/ssw/standards/Default.aspx コードルール：http ：//www.ssw.com.au/ssw/Standards/Rules/RulestoBetterCode.aspx

8 に答える 8