OleDbDataAdapter.UpdateCommand プロパティ

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

OleDbDataAdapter.UpdateCommand プロパティ

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

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

Visual Basic (宣言)

Public Property UpdateCommand As
 OleDbCommand

Visual Basic (使用法)

Dim instance As OleDbDataAdapter
Dim value As OleDbCommand

value = instance.UpdateCommand

instance.UpdateCommand = value

C#

public OleDbCommand UpdateCommand { get; set;
 }

C++

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

J#

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

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

JScript

public function get UpdateCommand
 () : OleDbCommand

public function set UpdateCommand
 (value : OleDbCommand)

プロパティ値
Update 処理中に、DataSet 内の変更行に対応するデータ ソース内のレコードを更新するための OleDbCommand。

解説

Update 処理中に、このプロパティが設定されておらず、DataSet に主キー情報が存在する場合、SelectCommand プロパティを設定し、OleDbCommandBuilder を使用しているときは、UpdateCommand が自動的に生成されます。続いて、設定していない追加のコマンドが、OleDbCommandBuilder によって生成されます。この生成ロジックでは、DataSet 内にキー列情報が存在している必要があります。詳細については、「コマンドの自動生成」を参照してください。

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

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

使用例

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

Visual Basic

Private Function CreateCustomerAdapter( _
    ByVal connection As OleDbConnection) As
 OleDbDataAdapter

    Dim dataAdapter As OleDbDataAdapter = New
 OleDbDataAdapter()
    Dim command As OleDbCommand
    Dim parameter As OleDbParameter

    ' Create the SelectCommand.
    command = New OleDbCommand("SELECT * FROM
 dbo.Customers " & _
        "WHERE Country = ? AND City = ?", connection)

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

    dataAdapter.SelectCommand = command

    ' Create the UpdateCommand.
    command = New OleDbCommand("UPDATE dbo.Customers
 " & _
        "SET CustomerID = ?, CompanyName = ? " &
 _
        "WHERE CustomerID = ?", connection)

    command.Parameters.Add( _
        "CustomerID", OleDbType.Char, 5, "CustomerID")
    command.Parameters.Add( _
        "CompanyName", OleDbType.VarChar, 40, "CompanyName")

    parameter = command.Parameters.Add( _
        "oldCustomerID", OleDbType.Char, 5, "CustomerID")
    parameter.SourceVersion = DataRowVersion.Original

    dataAdapter.UpdateCommand = command

    Return dataAdapter
End Function

C#

private static OleDbDataAdapter CreateCustomerAdapter(
    OleDbConnection connection)
{
    OleDbDataAdapter dataAdapter = new OleDbDataAdapter();
    OleDbCommand command;
    OleDbParameter parameter;

    // Create the SelectCommand.
    command = new OleDbCommand("SELECT * FROM dbo.Customers
 " +
        "WHERE Country = ? AND City = ?", connection);

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

    dataAdapter.SelectCommand = command;

    // Create the UpdateCommand.
    command = new OleDbCommand(
        "UPDATE dbo.Customers SET CustomerID = ?, CompanyName = ? " +
        "WHERE CustomerID = ?", connection);

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

    parameter = command.Parameters.Add(
        "oldCustomerID", OleDbType.Char, 5, "CustomerID");
    parameter.SourceVersion = DataRowVersion.Original;

    dataAdapter.UpdateCommand = command;

    return dataAdapter;
}

プラットフォーム

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、1.0

参照

関連項目
OleDbDataAdapter クラス
OleDbDataAdapter メンバ
System.Data.OleDb 名前空間
その他の技術情報
DataAdapter の使用