「型付DataSetに列挙型を取り込む」の版間の差分

2019年7月26日 (金) 16:39時点における版

型付DataSetに列挙型（enum）を取り込む場合、色々な方法があると思うんだ。一番簡単に想像できるのは、DataSetデザイナーで特定のテーブルの列の型を、ネームスペース含めて列挙型をしてしまうことなんだけど…。僕がやった限り、一回これをやってしまうとデータセットデザイナーが正しく開けなくなっちゃうんだよ。で、色々調べて・試してその結果たどり着いた（僕が）最善と思っている方法を紹介するよ。

考え方

色々やった結果…実はDataSetに列挙型を取り込むこと自体を諦めたんだよ…(^_^;)でも、コード上で毎回キャストしたくはなかったんだ…。そこで注目したのは、自動生成される型付DataSetはpartialクラスってことなんだ…。つまり、DataSetの定義は「Int32」でしておいて、DataSetのpartialを作って、そのクラスに列挙型で出し入れできるプロパティを作ってしまおうって事なんだよ。

partialクラスってなに？？？

partialクラスって言うのは、クラス定義を分割して定義している（ないしはできる）クラスのことを言うんだよ。たとえば、以下のようなクラスがあったとするよね…

namespace CommonCtrlLib
{
    public class Class1
    {
        private Int32 m_field_A;

        public Class1()
        {
            this.m_field_A = -1;
        }

        public Int32 field_A
        {
            get { return this.m_field_A; }
            set { this.m_field_A = value; }
        }

        public String field_B
        {
            get { return this.m_field_A.ToString(); }
            set { this.m_field_A = Int32.Parse(value); }
        }
    }
}

クラス内の定義って言うのはclass{}の中に記述しないといけないから、つまるところ１ファイルの中にすべて書かないといけないって事になっちゃうんだよね。でも、諸事情により別のファイルに書きたいときもあると思うんだ。自動生成されたDataSetのファイルなんかは特にそうで…自動生成されたファイルをカスタマイズしちゃうと、また自動生成したときにカスタマイズが消えちゃったりするんだ。そんなときに、自分のカスタマイズ部分だけ別のファイルに書ければ…ってことになるんだよ。

そんなときはclassをpartial型で定義するとできちゃうんだよ。

ファイル１

namespace TestLibrary
{
    public partial class Class1
    {
        private Int32 m_field_A;

        public Class1()
        {
            this.m_field_A = -1;
        }

        public Int32 field_A
        {
            get { return this.m_field_A; }
            set { this.m_field_A = value; }
        }
    }
}

ファイル２

namespace TestLibrary
{
    public partial class Class1
    {
        public String field_B
        {
            get { return this.m_field_A.ToString(); }
            set { this.m_field_A = Int32.Parse(value); }
        }
    }
}

こうやって定義すると、２つのファイルに分かれているclass定義でも、１つのclassとして扱うことができるんだ。

型付DataSetの作成

列挙型を取り込みたいって悩んでいる人には、このステップは用済みかもしれないけど一応書いておくね。VisualStudioを起動してプロジェクトを開いている前提で手順をあげるよ。

ソリューションエクスプローラーからDataSetを追加したいプロジェクトを右クリックする。
メニューから「追加」→「新しい項目」を選択する。
（Ｃ♯の）一覧からデータセットを選択し、名前に適当なファイル名を入れ、「追加」ボタンをクリックする。
デザイナーが開くので、ツールボックスからDataTableをデザイナーにドラッグアンドドロップしてテーブルを追加する。テーブル名は適当に変更する。
デザイナーのテーブルを右クリックして、「追加」→「列」を選択し、適当な列を追加する。
必要に応じてキーを設定する

ここで、列挙型を保存したい列の型を「System.Int32」に変更するんだよ。デザイナーで列を選択すると、プロパティウインドウに列のプロパティが表示されるんだ。その中の「DataType」プロパティの値を「System.Int32」に変更するんだよ。

partialクラスの追加

partialクラスを追加する方法もインターネットを調べると色々出てくるんだけど…どうやらMicrosoftはこの方法を推奨しているみたいなんだよ。

データセットデザイナを表示する。
データセットデザイナの何も書かれていないところ（余白？）をダブルクリックする。
以下のようなコードが表示される（ネームスペースが「TestLibrary」で、データセットクラス名が「DataSet1」の場合）
```
namespace TestLibrary {
    
    
    public partial class DataSet1 {
    }
}
```

これでDataSetのpartialクラスが追加されたんだよ。ソリューションエクスプローラーを見ても「xxxxx.xsd」ファイルの配下にこのpartialクラスのファイルが入っていて、見た目にもすっきりしていると思うんだ。

partialクラスにメソッドを追加

作成されたpartialクラスに列挙型で出し入れできる、プロパティを追加するよ。手順とかじゃなくて、追加したpartialクラスを以下の様に修正するんだよ。

namespace: TestLibrary
DataSet名: DataSet1
DataTable名: DataTable1
DataColumn名: DataColumn1
列挙型名: e_Test

namespace TestLibrary {
    public partial class DataSet1 {
        partial class DataTable1Row
        {
            public e_Test EnumDataColumn1
            {
                get
                {
                    return (e_Test)this.DataColumn1;
                }
                set
                {
                    this.DataColumn1 = (Int32)value;
                }
            }
        }
    }
}

これで、列挙型で出し入れできるメソッドを追加することができたよ。もしWPFでバインドしたいときなどは、Int32で取り出すメソッド（この場合「DataColumn1」）でバインドすれば、特に悩むことなく実現できると思うんだ。

参考サイト

MSDN - 方法 : データセットの機能を拡張する
 Gushwell's C# Dev Notes - DataSetのカラムで列挙型を扱うには

@@ 97行目: / 97行目: @@
 <li>データセットデザイナの何も書かれていないところ（余白？）をダブルクリックする。</li>
 <li>以下のようなコードが表示される（ネームスペースが「TestLibrary」で、データセットクラス名が「DataSet1」の場合）
-<source lang="csharp">
+<syntaxhighlight lang="C#">
 namespace TestLibrary {
@@ 104行目: / 104行目: @@
      }
 }
-</source>
+</syntaxhighlight>
 </li>
 </ol>