none
VC、VB、C#のコーディング規約について(命名規約) RRS feed

  • 質問

  • はじめまして
    VC、VB、、C#→2008版のコーディング規約を探しています、フォーラム等を検索したのですが見つからずコメントさせていただきます。
    ・コーディング規約または、命名規約を探しております。
    ・エリア名票の付与基準
    ・クラス名称の付与基準
    ・モジュール名称の付与基準などです
     また、テンプレートで自動生成はそのまま流用するなど
     宜しくお願いいたします

    2009年10月4日 3:36

回答

  • クラス ライブラリ開発のデザイン ガイドライン ぐらいでしょうか。あまり細かく決まっていないという印象です。
    というのも質問文にも「エリア名票」「モジュール」のようにそもそも用語を正しく扱ってもらえないぐらいですし。この2つって何を指しています?
    例えばモジュールですが、Assembly の中にModule が含まれる構造ですが、これを指しているわけではありませんよね。エリア名票においては見当もつかないです。

    ソースコードの書式はコーディング規約がどうこうよりも、「Visual Studioのドキュメントのフォーマットに任せる」ぐらいの方がいいですし。
    # とはいえ書式が拡張されてきてVisual Studioでフォーマットできない書式もあるのは何とかして欲しい。
    • 回答としてマーク toshi-su 2009年10月6日 1:21
    2009年10月4日 5:39
  • とりあえず以下が参考になると思います。

    .NETの命名規則
    http://dobon.net/vb/dotnet/beginner/namingrules.html


    ★良い回答には回答済みマークを付けよう! わんくま同盟 MVP - Visual C# http://blogs.wankuma.com/trapemiya/
    • 回答としてマーク toshi-su 2009年10月6日 1:07
    2009年10月4日 6:25
    モデレータ
  • そういうのってMSDNとどれだけ矛盾しないかが重要だと思います。 リンク先の
    イベント ハンドラ (イベントの型として使用されるデリゲート) の名前には、EventHandler というサフィックスを追加する。
    イベントのデザイン
    イベント ハンドラとして使用する新しいデリゲートを手動で作成する代わりに、System.EventHandler<T> を使用してください。
    という仕様変更に追従できていないんですよね。
    • 回答としてマーク toshi-su 2009年10月6日 1:20
    2009年10月4日 7:09
  • VC、VB、、C#→2008版のコーディング規約を探しています、フォーラム等を検索したのですが見つからずコメントさせていただきます。
    逆にお聞きしてみたいのですが、以前のバージョンでは、どこかのコーディング規約を参照されていたのでしょうか?

    MSDN 等ではガイドラインとしていくつか方針を明示していますが、細かなコーディング規約までは規定していないと思います。
    また、細かなコーディング規約は、部署毎とか、チーム毎とか、製品シリーズ毎とかに決めるべきだと思います。(万人に共通のコーディング規約は存在しないと考えるべき)
    解決した場合は、参考になった返信に「回答としてマーク」のボタンを利用して、回答に設定しましょう(複数に設定できます)。
    • 回答としてマーク toshi-su 2009年10月6日 1:20
    2009年10月4日 9:16
    モデレータ
  • コーディング規約は一つというわけではなく、最終的には自分のところに合ったものを作ることもあるでしょう。いいか悪いかは別としてLINQなどの新しい構文は禁止というところもあります。理由は開発者のレベルが一様に高くないという背景があるようです。ですから、見つかったコーディング基準(標準)を基に、ご自分に合った規約を検討することを忘れないようにして下さい。


    ★良い回答には回答済みマークを付けよう! わんくま同盟 MVP - Visual C# http://blogs.wankuma.com/trapemiya/
    • 回答としてマーク toshi-su 2009年10月6日 1:19
    2009年10月4日 9:17
    モデレータ

すべての返信

  • クラス ライブラリ開発のデザイン ガイドライン ぐらいでしょうか。あまり細かく決まっていないという印象です。
    というのも質問文にも「エリア名票」「モジュール」のようにそもそも用語を正しく扱ってもらえないぐらいですし。この2つって何を指しています?
    例えばモジュールですが、Assembly の中にModule が含まれる構造ですが、これを指しているわけではありませんよね。エリア名票においては見当もつかないです。

    ソースコードの書式はコーディング規約がどうこうよりも、「Visual Studioのドキュメントのフォーマットに任せる」ぐらいの方がいいですし。
    # とはいえ書式が拡張されてきてVisual Studioでフォーマットできない書式もあるのは何とかして欲しい。
    • 回答としてマーク toshi-su 2009年10月6日 1:21
    2009年10月4日 5:39
  • とりあえず以下が参考になると思います。

    .NETの命名規則
    http://dobon.net/vb/dotnet/beginner/namingrules.html


    ★良い回答には回答済みマークを付けよう! わんくま同盟 MVP - Visual C# http://blogs.wankuma.com/trapemiya/
    • 回答としてマーク toshi-su 2009年10月6日 1:07
    2009年10月4日 6:25
    モデレータ
  • そういうのってMSDNとどれだけ矛盾しないかが重要だと思います。 リンク先の
    イベント ハンドラ (イベントの型として使用されるデリゲート) の名前には、EventHandler というサフィックスを追加する。
    イベントのデザイン
    イベント ハンドラとして使用する新しいデリゲートを手動で作成する代わりに、System.EventHandler<T> を使用してください。
    という仕様変更に追従できていないんですよね。
    • 回答としてマーク toshi-su 2009年10月6日 1:20
    2009年10月4日 7:09
  • VC、VB、、C#→2008版のコーディング規約を探しています、フォーラム等を検索したのですが見つからずコメントさせていただきます。
    逆にお聞きしてみたいのですが、以前のバージョンでは、どこかのコーディング規約を参照されていたのでしょうか?

    MSDN 等ではガイドラインとしていくつか方針を明示していますが、細かなコーディング規約までは規定していないと思います。
    また、細かなコーディング規約は、部署毎とか、チーム毎とか、製品シリーズ毎とかに決めるべきだと思います。(万人に共通のコーディング規約は存在しないと考えるべき)
    解決した場合は、参考になった返信に「回答としてマーク」のボタンを利用して、回答に設定しましょう(複数に設定できます)。
    • 回答としてマーク toshi-su 2009年10月6日 1:20
    2009年10月4日 9:16
    モデレータ
  • コーディング規約は一つというわけではなく、最終的には自分のところに合ったものを作ることもあるでしょう。いいか悪いかは別としてLINQなどの新しい構文は禁止というところもあります。理由は開発者のレベルが一様に高くないという背景があるようです。ですから、見つかったコーディング基準(標準)を基に、ご自分に合った規約を検討することを忘れないようにして下さい。


    ★良い回答には回答済みマークを付けよう! わんくま同盟 MVP - Visual C# http://blogs.wankuma.com/trapemiya/
    • 回答としてマーク toshi-su 2009年10月6日 1:19
    2009年10月4日 9:17
    モデレータ