OracleDataAdapter.InsertCommand プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

OracleDataAdapter.InsertCommand プロパティ

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

名前空間: System.Data.OracleClient
アセンブリ: System.Data.OracleClient (system.data.oracleclient.dll 内)
構文

Visual Basic (宣言)

Public Property InsertCommand As
 OracleCommand

Visual Basic (使用法)

Dim instance As OracleDataAdapter
Dim value As OracleCommand

value = instance.InsertCommand

instance.InsertCommand = value

public OracleCommand InsertCommand { get; set;
 }

C++

public:
property OracleCommand^ InsertCommand {
    OracleCommand^ get ();
    void set (OracleCommand^ value);
}

/** @property */
public OracleCommand get_InsertCommand ()

/** @property */
public void set_InsertCommand (OracleCommand
 value)

JScript

public function get InsertCommand
 () : OracleCommand

public function set InsertCommand
 (value : OracleCommand)

プロパティ値
更新操作で DataSet 内の新しい行に対応するデータベース内のレコードを挿入するための OracleCommand。

解説

作成済みの OracleCommand オブジェクトに InsertCommand プロパティが割り当てられた場合、OracleCommand のクローンは作成されません。代わりに、InsertCommand によって、作成済みの OracleCommand への参照が維持されます。

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

メモ
このコマンドの実行によって行が返される場合、OracleCommand オブジェクトの .Data.OracleClient.OracleCommand.UpdatedRowSource プロパティの設定によっては、返された行が DataSet に追加されることがあります。

使用例

OracleDataAdapter を作成して SelectCommand プロパティと InsertCommand プロパティを設定する例を次に示します。ここでは、OracleConnection オブジェクトが既に作成されていることを前提にしています。

[Visual Basic]

Public Shared Function CreateCustomerAdapter(conn As OracleConnection) As OracleDataAdapter
 
  
  Dim da As OracleDataAdapter = New OracleDataAdapter()
  Dim cmd As OracleCommand

  ' Create the SelectCommand.

  cmd = New OracleCommand("SELECT * FROM Dept " & _
                       "WHERE DName = :pDName AND Loc = :pLoc", conn)

  cmd.Parameters.Add("pDName", OracleType.NVarChar, 14)
  cmd.Parameters.Add("pLoc", OracleType.NVarChar, 13)

  da.SelectCommand = cmd

  ' Create the InsertCommand.

  cmd = New OracleCommand("INSERT INTO Dept (DeptNo, DName) " & _
                       "VALUES (:pDeptNo, :pDName)", conn)

  cmd.Parameters.Add("pDeptNo", OracleType.Number, 2, "DeptNo")
  cmd.Parameters.Add("pDName", OracleType.NVarChar, 14, "DName")

  da.InsertCommand = cmd

  Return da
End Function

[C#]

public static OracleDataAdapter CreateCustomerAdapter(OracleConnection conn)
{
  OracleDataAdapter da = new OracleDataAdapter();
  OracleCommand cmd;

  // Create the SelectCommand.

  cmd = new OracleCommand("SELECT * FROM Dept " +
                       "WHERE DName = :pDName AND Loc = :pLoc", conn);

  cmd.Parameters.Add("pDName", OracleType.NVarChar, 14);
  cmd.Parameters.Add("pLoc", OracleType.NVarChar, 13);

  da.SelectCommand = cmd;

  // Create the InsertCommand.

  cmd = new OracleCommand("INSERT INTO Dept (DeptNo, DName) " +
                       "VALUES (:pDeptNo, :pDName)", conn);

  cmd.Parameters.Add("pDeptNo", OracleType.Number, 2, "DeptNo");
  cmd.Parameters.Add("pDName", OracleType.NVarChar, 14, "DName");

  da.InsertCommand = cmd;

  return da;
}