DbDataAdapter.UpdateCommand プロパティ

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

DbDataAdapter.UpdateCommand プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

データ ソース内のレコードを更新するコマンドを取得または設定します。

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

Visual Basic (宣言)

Public Property UpdateCommand As
 DbCommand

Visual Basic (使用法)

Dim instance As DbDataAdapter
Dim value As DbCommand

value = instance.UpdateCommand

instance.UpdateCommand = value

C#

public DbCommand UpdateCommand { get; set;
 }

C++

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

J#

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

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

JScript

public function get UpdateCommand
 () : DbCommand

public function set UpdateCommand
 (value : DbCommand)

プロパティ値
データ セット内の変更された行に対応するデータ ソース内のレコードを更新するために、Update 中に使用する IDbCommand。

解説

Update の処理中に、このプロパティが設定されておらず、DataSet に主キー情報が存在する場合、UpdateCommand が自動的に生成されます。

使用例

OleDbDataAdapter 派生クラスを作成し、そのプロパティの一部を設定する例を次に示します。

Visual Basic

Public Shared Function CreateCustomerAdapter(conn
 As OleDbConnection) As OleDbDataAdapter 
  
  Dim da As OleDbDataAdapter = New
 OleDbDataAdapter()
  Dim cmd As OleDbCommand
  Dim parm As OleDbParameter

  ' Create the SelectCommand.

  cmd = New OleDbCommand("SELECT * FROM Customers
 " & _
                       "WHERE Country = @Country AND City = @City",
 conn)

  cmd.Parameters.Add("@Country", OleDbType.VarChar,
 15)
  cmd.Parameters.Add("@City", OleDbType.VarChar, 15)

  da.SelectCommand = cmd

  ' Create the UpdateCommand.

  cmd = New OleDbCommand("UPDATE Customers
 SET CustomerID = @CustomerID, CompanyName = @CompanyName " & _
                       "WHERE CustomerID = @oldCustomerID",
 conn)

  cmd.Parameters.Add("@CustomerID", OleDbType.Char,
 5, "CustomerID")
  cmd.Parameters.Add("@CompanyName", OleDbType.VarChar,
 40, "CompanyName")

  parm = cmd.Parameters.Add("@oldCustomerID", OleDbType.Char,
 5, "CustomerID")
  parm.SourceVersion = DataRowVersion.Original

  da.UpdateCommand = cmd

  Return da
End Function

C#

public static OleDbDataAdapter CreateCustomerAdapter(OleDbConnection
 conn)
{
  OleDbDataAdapter da = new OleDbDataAdapter();
  OleDbCommand cmd;
  OleDbParameter parm;

  // Create the SelectCommand.

  cmd = new OleDbCommand("SELECT * FROM Customers "
 +
                       "WHERE Country = @Country AND City = @City", conn);

  cmd.Parameters.Add("@Country", OleDbType.VarChar, 15);
  cmd.Parameters.Add("@City", OleDbType.VarChar, 15);

  da.SelectCommand = cmd;

  // Create the UpdateCommand.

  cmd = new OleDbCommand("UPDATE Customers SET CustomerID
 = @CustomerID, CompanyName = @CompanyName " +
                       "WHERE CustomerID = @oldCustomerID", conn);

  cmd.Parameters.Add("@CustomerID", OleDbType.Char, 5, "CustomerID");
  cmd.Parameters.Add("@CompanyName", OleDbType.VarChar, 40, "CompanyName");

  parm = cmd.Parameters.Add("@oldCustomerID", OleDbType.Char, 5, "CustomerID");
  parm.SourceVersion = DataRowVersion.Original;

  da.UpdateCommand = cmd;

  return da;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間