データセットを作成する - xsdファイルの作成 (.NET)

.NET 5/6/7/8 アプリケーションでデータセットを利用するためのデータセット定義ファイル(xsdファイル)を作成する手順を紹介します。

こちらの記事ではDataGridView設置時に自動的にデータセットを作成しましたが、この記事では手動でデータセットを作成する手順を紹介します。

xsdファイルとは

DataSetのためのスキーマを定義するXMLファイルです。(XML Scheme Definition)
xsdファイルを定義しておくことで型付のDataSetを利用できます。

作成手順

[ソリューションエクスプローラー]でデータセットを追加したいプロジェクトのノードをクリックして選択します。 右クリックしてポップアップメニューを表示します。メニューの[追加]の[新しい項目]をクリックします。
データセットを作成する - xsdファイルの作成 (.NET):画像1

[新しい項目の追加]ダイアログが表示されます。
データセットを作成する - xsdファイルの作成 (.NET):画像2

中央の項目のリストから[DataSet]の項目をクリックして選択します。ダイアログ下部の[名前]テキストボックスにデータセットのxsdファイルの名前を設定します。 今回はデフォルトの"DataSet1.xsd"とします。設定ができたらダイアログ右下の[追加]ボタンをクリックします。
データセットを作成する - xsdファイルの作成 (.NET):画像3

データセットが作成され、下図のデータセット デザイナーの画面が表示されます。
データセットを作成する - xsdファイルの作成 (.NET):画像4

データセットデザイナーのエリアで右クリックします。下図のポップアップメニューが表示されますので[追加]メニューの[TableAdapter]の項目をクリックします。
データセットを作成する - xsdファイルの作成 (.NET):画像5

[TableAdapter 構成ウィザード]のダイアログが表示されます。
[アプリケーションがデータベースへの接続に使用するデータ接続を指定して下さい。]のコンボボックスでデータベースの接続を選択します。接続が無い場合や新しい接続を作成する場合はコンボボックス右側の[新しい接続]ボタンをクリックして新しい接続を作成します。
データセットを作成する - xsdファイルの作成 (.NET):画像6

[この接続文字列にはデータベース接続に必要な重要情報(例:パスワード)が含まれています。接続文字列内に重要な情報を保存するとセキュリティ上の問題が発生する可能性があります。接続文字列にこの重要情報を含めますか]の設定をします。
今回はシンプルにするため[はい、重要情報を接続文字列に含めます]のラジオボタンにチェックをします。チェック後[次へ]ボタンをクリックします。
データセットを作成する - xsdファイルの作成 (.NET):画像7

[コマンドの種類を選択]画面が表示されます。今回は[SQL ステートメントを使用]を選択します。ラジオボタンをチェックし[次へ]ボタンをクリックします。
データセットを作成する - xsdファイルの作成 (.NET):画像8

[SQL ステートメントの入力]画面が表示されます。
データセットを作成する - xsdファイルの作成 (.NET):画像9

レコードを取得するためのSQL文を入力します。クエリをGUIで作成するためのクエリ ビルダーを利用する場合はクエリ入力ボックスの右下の[クエリ ビルダー]ボタンをクリックします。」 GUIでクエリを作成するクエリ ビルダーのウィンドウが表示されクエリの作成ができます。
SQL文を設定できたら[次へ]ボタンをクリックします。
データセットを作成する - xsdファイルの作成 (.NET):画像10

[生成するメソッドの選択]画面が表示されます。メソッド名を設定します。今回はデフォルトの値を利用します。[次へ]ボタンをクリックします。
データセットを作成する - xsdファイルの作成 (.NET):画像11

[ウィザードの結果]画面が表示されます。ウィザードによってSQLのステートメントやメソッドが生成されます。[完了]ボタンをクリックしてウィザードを終了します。
データセットを作成する - xsdファイルの作成 (.NET):画像12

データセットデザイナーの画面に戻ると、DataTableとTableAdapterが作成されています。
データセットを作成する - xsdファイルの作成 (.NET):画像13

また、ソリューションエクスプローラーのファイル一覧に "DataSet1.xsd" ファイルが作成されています。
データセットを作成する - xsdファイルの作成 (.NET):画像14

AuthorPortraitAlt
著者
iPentecのメインプログラマー
C#, ASP.NET の開発がメイン、少し前まではDelphiを愛用
作成日: 2021-05-17
Copyright © 1995–2025 iPentec all rights reserverd.