Language

OracleDataAdapter.InsertCommand プロパティ

定義

データベースに新しいレコードを挿入するために使用する SQL ステートメントまたはストアド プロシージャを取得または設定します。

public:
 property System::Data::OracleClient::OracleCommand ^ InsertCommand { System::Data::OracleClient::OracleCommand ^ get(); void set(System::Data::OracleClient::OracleCommand ^ value); };
public System.Data.OracleClient.OracleCommand InsertCommand { get; set; }
member this.InsertCommand : System.Data.OracleClient.OracleCommand with get, set
Public Property InsertCommand As OracleCommand

プロパティ値

OracleCommand更新操作中に、DataSetの新しい行に対応するレコードをデータベースに挿入するために使用されます。

注釈

以前に作成したInsertCommand オブジェクトに OracleCommand プロパティが割り当てられている場合、OracleCommandは複製されません。 代わりに、 InsertCommand は、以前に作成した OracleCommandへの参照を保持します。

更新操作中に、 InsertCommand が設定されておらず、主キー情報が DataSetに存在する場合は、 OracleCommandBuilder クラスを使用して InsertCommandを自動的に生成し、 DataSet をデータベースに調整するために必要な追加のコマンドを使用できます。 これを行うには、SelectCommandのOracleDataAdapterプロパティを設定します。 生成ロジックでは、キー列の情報が DataSetに存在する必要もあります。 詳細については、「 CommandBuilders を使用したコマンドの生成」を参照してください。

Note

このコマンドを実行すると行が返される場合は、DataSet オブジェクトのUpdatedRowSource プロパティの設定方法に応じて、これらの行がOracleCommandに追加される可能性があります。

LONG RAWデータ型で列を更新すると、列に NULL の値を入力すると例外がスローされます。 Oracle LONG RAW データ型は、Oracle バージョン 8.0 では非推奨の型です。 このエラーを回避するには、BLOBではなくLONG RAWデータ型を使用します。

適用対象

こちらもご覧ください