mxb Blog

Disney好きな.NET Blog

目次

Blog 利用状況

記事カテゴリ

書庫

日記カテゴリ

Main Home Page

ASP.NETコーディング基準書 0100版 第1章

第1章 ネーミングルール
各種オブジェクトのネーミングルールについて説明しています。
http://mxb.wankuma.com/archive/ASP_NET_Coding_0100_1st.txt

投稿日時 : 2008年4月20日 6:21

コメントを追加

# re: ASP.NETコーディング基準書 0100版 第1章 2008/04/20 8:24 やじゅ

今のプロジェクトでは、ローマ字はヘボン式でも
+αして表記してます。
こういうのも定義するといいですよ。

OU→Oとする
数量 SURYOU → SURYO
摘要 TEKIYOU → TEKIYO
あと番号の付ける位置とかも定義してます。
受注区分1と受注区分2があったとして
JUCHU_KBN1、JUCHU_KBN2

JUCHU1_KBN、JUCHU2_KBN

# re: ASP.NETコーディング基準書 0100版 第1章 2008/04/20 9:30 はつね

この名前付き規則を適用した場合、VSのコード分析ツールで警告はどれくらいでるのでしょうか。つまり、.NET標準と異なる部分を明確に把握されていますか?


(1)
Pascal形式の説明で2文字までのときは大文字にするとの事ですが、先頭だけの話ではないのでしょうか。例外としてはIDのように略称のときはどこに入っても大文字になります。
なので、例にIDのみを取り上げているのが不適切です。また、User_IdはUser_IDになるはずです。それとも、この命名規約では略称というものに特別扱いはしないという事でしょうか。

(2)
Constで定義した変数を大文字命名として区別するのは意味があるのでしょうか。パターンを増やすよりも変数としての命名規約に則ればいいのでは?

(3)
画面コントロール(オブジェクト)名にプレフィックスがつく利点はなんでしょうか。コントロールの種類がコード上で判定できるというのは利点としては弱いと思います。.NETになって同じ意味のプロパティは同じプロパティ名に統一されるなどコントロールの種類を意識しないでもコードが読めるはずなのに時代に逆行していませんか?
それに、ここで大量の略称が発生するのも規約を覚えづらくする一因になると思います。
それに、ButtonコントロールとhtmlのButtonが同じプレフィックスにしていますが、この両者の方がよほど(ASP.NETコントロール同士、html同士)よりも相違が大きいのではないでしょうか。

# re: ASP.NETコーディング基準書 0100版 第1章 2008/04/20 9:31 はつね

勉強会の当日に、他の方も色々発言されていて、そちらの意見の方がもっともだと思っていたのですが、そのときのディスカッションの内容は反映されていないのでしょうか。

# re: ASP.NETコーディング基準書 0100版 第1章 2008/04/20 12:53 NAL-6295

はつねさんの(1),(2),(3)に重なりますので、重ならない点だけ。

1.識別子に2バイト文字(全角かなとか漢字のこと?)を使うと拡張性や接続性が損なわれるという主張がいまいち理解できませんでした。

2.パラメータが参照渡しか値渡しかで、プリフィックスを付けると何が良いのかわかりませんでした。
メソッドの機能が参照渡しを必要としているからパラメータが参照渡しになっている事を考えると、特に明示する必要も無いかなと思いました。

3.はつねさんの(3)に若干かぶりますが、
「型名を表すコード ハンガリアン表記法は使用しない。」と「画面コントロールにプレフィックスをつける」という部分が矛盾しているように感じました。

# re: ASP.NETコーディング基準書 0100版 第1章 2008/04/22 1:02 mxb

ご意見有難う御座います。
今読み返してみると確かに矛盾点がありますね。
5/31の東京勉強会で纏めて発表させて頂きます。
これからもコメント宜しくお願い致します。

# バーバリー通販サイト 2012/11/06 15:54 http://burberry.suppa.jp/

こんにちは、またブログ覗かせていただきました。また、遊びに来ま~す。よろしくお願いします

タイトル
名前
URL
コメント