OracleDataAdapter.UpdateCommand プロパティ

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

OracleDataAdapter.UpdateCommand プロパティ

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

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

Visual Basic (宣言)

Public Property UpdateCommand As
 OracleCommand

Visual Basic (使用法)

Dim instance As OracleDataAdapter
Dim value As OracleCommand

value = instance.UpdateCommand

instance.UpdateCommand = value

C#

public OracleCommand UpdateCommand { get; set;
 }

C++

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

J#

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

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

JScript

public function get UpdateCommand
 () : OracleCommand

public function set UpdateCommand
 (value : OracleCommand)

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

解説

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

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

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

使用例

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

[Visual Basic]

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

  ' 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 UpdateCommand.

  cmd = New OracleCommand("UPDATE Dept SET DeptNo = pDeptNo, DName = pDName " &
 _
                       "WHERE DeptNo = poldDeptNo", conn)

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

  parm = cmd.Parameters.Add("poldDeptNo", OracleType.Number, 2, "DeptNo")
  parm.SourceVersion = DataRowVersion.Original

  da.UpdateCommand = cmd

  Return da
End Function

[C#]

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

  // 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 UpdateCommand.

  cmd = new OracleCommand("UPDATE Dept SET DeptNo = pDeptNo, DName = pDName " +
                       "WHERE DeptNo = poldDeptNo", conn);

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

  parm = cmd.Parameters.Add("poldDeptNo", OracleType.Number, 2, "DeptNo");
  parm.SourceVersion = DataRowVersion.Original;

  da.UpdateCommand = cmd;

  return da;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1

参照

関連項目
OracleDataAdapter クラス
OracleDataAdapter メンバ
System.Data.OracleClient 名前空間
OracleDataAdapter.DeleteCommand プロパティ
OracleDataAdapter.InsertCommand プロパティ
OracleDataAdapter.SelectCommand プロパティ