ダイアログボックス

2011-08-09

アダプターに対して SQL ステートメントまたはストアドプロシージャを作成する方法を制御できます。データウィザードのいずれかで [SQL ステートメントの生成] ページの [詳細オプション] ボタンをクリックすると、このダイアログボックスが表示されます。このダイアログボックスのオプションはすべて、CustomersTableAdapter.Update(DataTable) などの更新プロシージャの一部として呼び出されるステートメントまたはプロシージャに関係します。

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

[INSERT、UPDATE、および DELETE ステートメントの生成]
これをオンにすると、ウィザードでは、アダプターの UpdateCommand、InsertCommand、および DeleteCommand の各オブジェクトに対する SQL ステートメントまたはストアドプロシージャが作成されます。生成されるステートメントまたはプロシージャの詳細については、ウィザードのクエリの種類の選択ペインで制御されます。このチェックボックスをオフにすると、ダイアログボックスの残りのオプションは使用できなくなり、適用されません。

このチェックボックスをオフにするのは、普通、次のような場合です。
- データソースからデータを読み取るためだけにアダプターを使い、書き込みには使用しない場合。このチェックボックスをオフにすると、フォームまたはコンポーネントのコードが少なくなります。
- ウィザードが終了した後、自分でコマンドを記述する場合。
チェックボックスをオフにし、UpdateCommand、InsertCommand、または DeleteCommand の各オブジェクトに対するステートメントまたはストアドプロシージャを生成しない場合は、データアダプターの Update メソッドを呼び出しても何も行われません。
[オプティミスティック同時実行制御]
オンにすると、ウィザードは、更新されているレコードのすべての列の値をデータベース内の対応するレコードと一致させる WHERE 句を含む SQL コマンドを生成します。

注意

このオプションは、[INSERT、UPDATE、および DELETE ステートメントの生成] チェックボックスがオンになっている場合にだけ使用できます。

たとえば、このオプションを使って生成される UPDATE ステートメントの構文は次のようになります。
```
UPDATE Customers
SET CustomerID = ?, CompanyName = ?, Phone = ?
WHERE (CustomerID = ?) AND (CompanyName = ?) AND 
      (Phone = ? OR ? IS NULL AND Phone IS NULL);
```
このチェックボックスをオフにすると、構文は次のようになります。
```
UPDATE Customers
SET CustomerID = ?, CompanyName = ?, Phone = ?
WHERE (CustomerID = ?)
```
各列の値をチェックすることによる影響として、データセットを読み取った後で他のユーザーがレコードを変更したことにより列が変更された場合、コマンドはエラーになります。このオプションを設定せず、WHERE 句が単純にレコードを特定するだけの場合は、そのレコードを更新すると、ほかのユーザーが行った変更が警告なしにオーバーライドされる場合があります。

データセット更新時の同時実行チェックの詳細については、「ADO.NET におけるデータ同時実行制御の概要」を参照してください。
[データテーブルの更新]
オンにすると、ウィザードは、それぞれの Update コマンドおよび Insert コマンドに対して Select ステートメントを生成します。

注意

このオプションは、[INSERT、UPDATE、および DELETE ステートメントの生成] チェックボックスがオンになっている場合にだけ使用できます。

Select ステートメントは、アダプター内の対応するコマンドオブジェクトに追加されて、Update コマンドまたは Insert コマンドが終了した直後に実行されます。 Select ステートメントは、ただ 1 つのレコード、つまり更新されたばかりのレコードの更新バージョンを返すように構成されます。

注意

ステートメントをセミコロン (;) で区切ることにより、アダプターのコマンドオブジェクトの CommandText プロパティに複数のステートメントを追加できます。

更新後のレコードを取得すると、そのレコードの更新された列の値がデータセットに書き込まれます。次の列も対象になります。
- データベースが既定値を格納する列
- 自動インクリメントされる列
- タイムスタンプ列
- データベーストリガーの結果によって影響を受ける列
このオプションを指定すると、更新のたびに 2 つのステートメント (更新ステートメントとその後の Select ステートメント) が実行されるので、データベース内のほとんどのレコードが更新される場合は非効率的です。この場合は、すべての更新が行われた後で、単純にデータテーブル全体を一度に設定し直すのが最も効率的です。

注意

データテーブルの再表示は、SQL ステートメントのバッチ処理がサポートされたデータベースのみで使用できます。たとえば、Microsoft Access では、データテーブルの再表示は、他の操作を実行するコマンドと同じコマンドで実行できません。