OdbcDataAdapter.UpdateCommand プロパティ

メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。

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

Public Shadows Property UpdateCommand As OdbcCommand
[C#]
public new OdbcCommand UpdateCommand {get; set;}
[C++]
public: __property OdbcCommand* get_UpdateCommand();public: __property void set_UpdateCommand(OdbcCommand*);
[JScript]
public hide function get UpdateCommand() : OdbcCommand;public function set UpdateCommand(OdbcCommand);

プロパティ値

更新操作で、 DataSet 内の変更行に対応するデータ ソース内のレコードを更新するための OdbcCommand 。

解説

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

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

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

使用例

[Visual Basic, C#, C++] OdbcDataAdapter を作成して SelectCommand プロパティと UpdateCommand プロパティを設定する例を次に示します。ここでは、 OdbcConnection オブジェクトが既に作成されていることを前提にしています。

 
Public Shared Function CreateCustomerAdapter(conn As OdbcConnection) As OdbcDataAdapter 
  
  Dim da As OdbcDataAdapter = New OdbcDataAdapter()
  Dim cmd As OdbcCommand
  Dim parm As OdbcParameter

  ' Create the SelectCommand.

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

  cmd.Parameters.Add("@Country", OdbcType.NVarChar, 15)
  cmd.Parameters.Add("@City", OdbcType.NVarChar, 15)

  da.SelectCommand = cmd

  ' Create the UpdateCommand.

  cmd = New OdbcCommand("UPDATE Customers SET CustomerID = ?, CompanyName = ? " & _
                       "WHERE CustomerID = ?", conn)

  cmd.Parameters.Add("@CustomerID", OdbcType.NChar, 5, "CustomerID")
  cmd.Parameters.Add("@CompanyName", OdbcType.NVarChar, 40, "CompanyName")

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

  da.UpdateCommand = cmd

  Return da
End Function

[C#] 
public static OdbcDataAdapter CreateCustomerAdapter(OdbcConnection conn)
{
  OdbcDataAdapter da = new OdbcDataAdapter();
  OdbcCommand cmd;
  OdbcParameter parm;

  // Create the SelectCommand.

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

  cmd.Parameters.Add("@Country", OdbcType.NVarChar, 15);
  cmd.Parameters.Add("@City", OdbcType.NVarChar, 15);

  da.SelectCommand = cmd;

  // Create the UpdateCommand.

  cmd = new OdbcCommand("UPDATE Customers SET CustomerID = ?, CompanyName = ? " +
                       "WHERE CustomerID = ?", conn);

  cmd.Parameters.Add("@CustomerID", OdbcType.NChar, 5, "CustomerID");
  cmd.Parameters.Add("@CompanyName", OdbcType.NVarChar, 40, "CompanyName");

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

  da.UpdateCommand = cmd;

  return da;
}

[C++] 
public:
    static OdbcDataAdapter* CreateCustomerAdapter(OdbcConnection* conn)
    {
        OdbcDataAdapter* da = new OdbcDataAdapter();
        OdbcCommand* cmd;
        OdbcParameter* parm;

        // Create the SelectCommand.
        cmd = new OdbcCommand(S"SELECT * FROM Customers WHERE Country = ? AND City = ?", conn);

        cmd->Parameters->Add(S"@Country", OdbcType::NVarChar, 15);
        cmd->Parameters->Add(S"@City", OdbcType::NVarChar, 15);

        da->SelectCommand = cmd;

        // Create the UpdateCommand.
        cmd = new OdbcCommand(S"UPDATE Customers SET CustomerID = ?, CompanyName = ? WHERE CustomerID = ?", conn);

        cmd->Parameters->Add(S"@CustomerID", OdbcType::NChar, 5, S"CustomerID");
        cmd->Parameters->Add(S"@CompanyName", OdbcType::NVarChar, 40, S"CompanyName");

        parm = cmd->Parameters->Add(S"@oldCustomerID", OdbcType::NChar, 5, S"CustomerID");
        parm->SourceVersion = DataRowVersion::Original;

        da->UpdateCommand = cmd;

        return da;
    };

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

OdbcDataAdapter クラス | OdbcDataAdapter メンバ | System.Data.Odbc 名前空間 | DeleteCommand | InsertCommand | SelectCommand