ダイアログボックス

2011-08-09

1 つ以上のデータアダプターで指定される情報から型指定されたデータセットクラスを生成するためのオプションを表示できます。このダイアログボックスは、次の場合に使用します。

新しい型付きクラスを作成する。
既存のデータセットクラスにテーブルを追加する、またはデータセットに既に存在するテーブルの列の定義を変更する。

注意

データセットクラスからテーブルを削除するには、データセットデザイナーを使ってデータセットのスキーマを編集します。詳細については、「データセットデザイナー」を参照してください。

このダイアログボックスの結果として生成される型指定されたデータセットクラスは、.xsd ファイルおよびそれに対応してスキーマ情報を取り込むクラス (.vb など) ファイルという 2 つのファイルとして、プロジェクトに格納されます。

[データセットの生成] ダイアログボックスを表示するには、フォームまたはコンポーネントで 1 つまたは複数のデータアダプターを選択し、ショートカットメニューの [データセットの生成] をクリックします。

ユーザーインターフェイス要素の一覧

[データセットの選択]
新しいデータセットクラスを生成するのか、または既存のデータセットクラスを生成し直すのかを選択します。次のどちらかのオプションを選択します。
- [既存] このオプションは、既存のデータセットクラスにテーブルを追加または再度追加することを指定します。一覧で更新するデータセットを選択します。
- [新規] このオプションを指定すると、新しいデータセットクラスの名前を指定できます。
[データセットに追加するテーブルの選択]
データセットに追加するテーブルを指定します。テーブルの一覧は、フォームまたはコンポーネントのデータアダプターから取得されます。各データアダプターは、普通、1 つのテーブルにアクセスします。生成するテーブルの名前は、アダプターの TableMappings プロパティから取得されます。テーブルマップが指定されていない場合、テーブル名はデータソースから渡されます。

データセットに追加する (または追加し直す) テーブルの名前をチェックします。

注意

データセットに既に存在するテーブルの名前をクリアしても、データセットからそのテーブルが削除されることはありません。名前をクリアするということは、単に、データセットにテーブルを追加し直さないことを意味しています。

テーブルを追加して既存のデータセットを更新すると、次の処理が行われます。
- データセットにまだ存在しないテーブルの場合は、テーブルの定義がデータセットにマージされます。既にデータセットに存在するテーブル、リレーションシップ、およびその他の構造は、すべてそのままになります。
- データセットに既に存在するテーブルの場合は、新しいテーブルの定義で古い定義がオーバーライドされます。たとえば、新しいテーブル定義の方が列が少ない場合は、実質的にデータセットから列が削除されます。
[このデータセットをデザイナーに追加する]
このデータセットのインスタンスを現在のフォームに追加するかどうかを指定します。インスタンスは作成する必要がない場合があります。
- 現在のフォームでデータセットを使用せず、代わりに別のコンポーネントで使用する場合。
- スキーマファイルを作成するためだけにデータセットクラスを生成している場合。
データセットのインスタンスは、データセットの名前に加えてシーケンシャル番号を使用します。たとえば、Dataset1 という名前のデータセットの場合、1 番目のインスタンスの名前は Dataset11 に、2 番目のインスタンスの名前は Dataset12 になります。フォームまたはコンポーネントでのインスタンスの名前は、[プロパティ] ウィンドウで変更できます。