DB2DataAdapter.InsertCommand プロパティー

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

ネーム・スペース:: IBM.Data.DB2
アセンブリー:: IBM.Data.DB2 ( IBM.Data.DB2.dll内)

構文


[Visual Basic]
Public Property InsertCommand As DB2Command

[C#]
public new DB2Command
 InsertCommand {get; set;}
[C++]
public: __property DB2Command
* get_InsertCommand();
public: __property void set_InsertCommand(DB2Command
*);
[JScript]
public function get InsertCommand() : DB2Command
;
public function set InsertCommand(DB2Command
);

プロパティー値

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

注釈

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

更新操作中に、 InsertCommand が設定されておらず、1 次キー情報が DataSetに存在する場合は、 DB2CommandBuilder クラスを使用して、 InsertCommandと、 DataSet をデータベースに調整するために必要な追加コマンドを自動的に生成できます。これを行うには、 DB2DataAdapterの SelectCommand プロパティーを設定します。この生成ロジックでは、キー列情報が DataSet に存在していることも必要となります。詳しくは、Microsoft(R) .NET Framework SDK 資料の『Automatically Generated Commands』を参照してください。

注: このコマンドの実行で行が返された場合、 DB2Command オブジェクトの DB2Command.UpdatedRowSource プロパティーをどのように設定したかに応じて、これらの行が DataSet に追加されることがあります。

例

[Visual Basic、C#] 以下の例では、 DB2DataAdapter を作成し、そのプロパティーの一部を設定します。

[Visual Basic]
Public Sub CreateDB2DataAdapter()
     Dim mySelectText As String = _
        "SELECT * FROM STAFF ORDER BY ID"
     Dim myConnString As String = _
        "DATABASE=SAMPLE;"
     Dim myDataAdapter As New DB2DataAdapter(mySelectText, myConnString)
     Dim myDataAdapter.InsertCommand As New DB2Command(
       "INSERT INTO STAFF 
       VALUES ( 360, 'Johnson',84,'Clerk',2,11500.00, 100.00)", myConnString)
End Sub

[C#]
public void CreateDB2DataAdapter ()
{
    string mySelectText = "SELECT * FROM STAFF ORDER BY ID";
    string myConnString = "DATABASE=SAMPLE;";
    DB2DataAdapter myDataAdapter = new DB2DataAdapter(mySelectText,myConnString);
    myDataAdapter.InsertCommand = new DB2Command(
      "INSERT INTO STAFF 
      VALUES ( 360, 'Johnson',84,'Clerk',2,11500.00, 100.00)", myConnString);
}