パラメーターと DB2 DataAdapter
DataAdapterクラスには、データの取得とデータ ソースSelectCommandへのデータの更新に使用される 4 つのプロパティがあります。このプロパティは、データ ソースからデータを返します。、UpdateCommand、および DeleteCommand プロパティは、データ ソースInsertCommandでの変更を管理するために使用されます。 オブジェクトの メソッドを SelectCommand 呼び出す前に、 プロパティを Fill 設定する DataAdapter 必要があります。 InsertCommand、UpdateCommand、DeleteCommand の各プロパティは、Update 内のデータに加えられた変更に応じて、DataAdapter の DataSet メソッドを呼び出す前に設定する必要があります。 たとえば、行が追加されている場合は、 メソッドを呼び出す前に プロパティを InsertCommand 設定する Update 必要があります。 挿入、更新、または削除された行を処理している場合 Update 、 DataAdapter オブジェクトはそれぞれの Command プロパティを使用してアクションを処理します。 変更された行に関する現在の情報が Command コレクションを経由して Parameters オブジェクトに渡されます。
データ ソースで行を更新する場合は、UPDATE ステートメントを呼び出します。このステートメントでは、一意の識別子を使用して、更新するテーブル内の行を識別します。 一意識別子は、通常、主キー フィールドの値です。 UPDATE ステートメントでは、一意の識別子と、更新する列と値の両方を含むパラメーターが使用されます。
型をParameter指定すると、値をデータ ソースに渡す前に、Parameter の値が DB2 のマネージド プロバイダーに変換されます。 オブジェクトの プロパティを特定の Parameter に設定 DbType することで、 の型を Parameter 一般的な方法で指定 DbTypeすることもできます。
ParameterDirection 列挙値
次の表は、 列挙で を設定Directionするために使用ParameterDirectionできる値をParameter示しています。
| メンバー名 | 説明 |
|---|---|
| 入力 | このパラメーターは入力パラメーターです。 既定値です。 |
| InputOutput | このパラメーターは入力または出力のどちらでもできます。 |
| 出力 | このパラメーターは出力パラメーターです。 |
| ReturnValue | パラメーターは戻り値を表します。 |
SourceColumn と SourceVersion は、コンストラクターに Parameter 引数として渡すことも、既存 Parameterの のプロパティとして設定することもできます。 は SourceColumn 、 の DataColumn 値が取得される から DataRow の Parameter 名前です。 はSourceVersion、値の取得にDataAdapter使用するDataRowバージョンを指定します。
DataRowVersion 列挙値
DataRowVersion で使用できる SourceVersion 列挙型の値を次の表に示します。
| メンバー名 | 説明 |
|---|---|
| Current | このパラメーターは列の現在の値を使用します。 既定値です。 |
| 既定 | パラメーターは、列の DefaultValue を使用します。 |
| 変更元 | このパラメーターは列の元の値を使用します。 |
| 提案 | このパラメーターは提示された値を使用します。 |
オブジェクトの プロパティを使用してUpdatedRowSource、データ ソースから返される値をDataSetオブジェクトにマップし直す方法をCommand制御できます。 プロパティをUpdatedRowSource列挙値のいずれかにUpdateRowSource設定すると、コマンドによって返されるパラメーターを無視するか、オブジェクト内DataSetのDataAdapter変更された行に適用するかを制御できます。 また、最初に返された行 (存在する場合) を オブジェクトの DataSet 変更された行に適用するかどうかを指定することもできます。
UpdateRowSource 列挙値
次の表では、列挙体のさまざまな UpdateRowSource 値と、それらが オブジェクトで DataAdapter 使用されるコマンドの動作に与える影響について説明します。
| メンバー名 | 説明 |
|---|---|
| 両方 | 出力パラメーターと返された結果セットの最初の行の両方を、 の変更された行に DataSetマップできます。 |
| ReturnedFirstRecord | 返された結果セットの最初の行のデータのみを、 の変更された行に DataSetマップできます。 |
| なし | 出力パラメーターまたは返された結果セットの行が無視されます。 |
| OutputParameters | 出力パラメーターだけを DataSet 内の変更行に割り当てます。 |