DataSourceView.ExecuteUpdate メソッド

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

DataSourceView.ExecuteUpdate メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

DataSourceView オブジェクトで表されたデータのリストに対して、更新操作を実行します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Function
 ExecuteUpdate ( _
    keys As IDictionary, _
    values As IDictionary, _
    oldValues As IDictionary _
) As Integer

Visual Basic (使用法)

Dim keys As IDictionary
Dim values As IDictionary
Dim oldValues As IDictionary
Dim returnValue As Integer

returnValue = Me.ExecuteUpdate(keys, values, oldValues)

C#

protected virtual int ExecuteUpdate (
    IDictionary keys,
    IDictionary values,
    IDictionary oldValues
)

C++

protected:
virtual int ExecuteUpdate (
    IDictionary^ keys, 
    IDictionary^ values, 
    IDictionary^ oldValues
)

J#

protected int ExecuteUpdate (
    IDictionary keys, 
    IDictionary values, 
    IDictionary oldValues
)

JScript

protected function ExecuteUpdate (
    keys : IDictionary, 
    values : IDictionary, 
    oldValues : IDictionary
) : int

パラメータ

keys

更新操作で更新するオブジェクト キーまたは行キーで構成される IDictionary。

values

データ要素およびその新しい値を表す名前/値ペアで構成される IDictionary。

oldValues

データ要素およびその元の値を表す名前/値ペアで構成される IDictionary。

戻り値
基になるデータ ストレージで更新された項目数。

例外

例外の種類	条件
NotSupportedException	ExecuteUpdate 操作は DataSourceView ではサポートされません。

解説

データ バインド コントロールでは、DataSourceControl.GetView メソッドを使用して DataSourceView オブジェクトを取得し、CanUpdate プロパティを確認することにより、ExecuteUpdate 操作がデータ ソース コントロールでサポートされるかどうかを判断できます。

keys パラメータは、更新するデータのオブジェクト キーまたは行キーを表します。SqlDataSource コントロールなど、リレーショナル データを表すデータ ソースの場合、keys パラメータはデータベースの主キーのコレクションです。その他の場合は、keys パラメータは名前/値ペアであり、データのリストをフィルタ処理するために使用されます。名前/値ペアに一致するすべての値が、既存のフィールドまたは列の新しい値を表す一連の名前/値ペアである values パラメータ内で検出された値で更新されます。

メモ
DataSourceView クラスの既定の実装では、NotSupportedException 例外がスローされます。DataSourceView クラスを拡張する場合、そのクラスで基になるデータ ストレージのデータ更新をサポートするには、ExecuteUpdate メソッドをオーバーライドします。

使用例

DataSourceView クラスを拡張するクラスで、CanUpdate プロパティと ExecuteUpdate メソッドをオーバーライドする方法を次のコード例に示します。このコード例は、DataSourceView クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

   ' The CsvDataSourceView does not currently
   ' permit update operations. You can modify or
   ' extend this sample to do so.
   Public Overrides ReadOnly
 Property CanUpdate() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function
 ExecuteUpdate(keys As IDictionary, _
                                              values As IDictionary,
 _
                                              oldValues As IDictionary)
 As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteUpdate

End Class 'CsvDataSourceView

C#

// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
    get {
        return false;
    }
}
protected override int ExecuteUpdate(IDictionary
 keys, IDictionary values, IDictionary oldValues)
{
    throw new NotSupportedException();
}

プラットフォーム

Windows 98, Windows 2000 SP4, 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

参照

関連項目
DataSourceView クラス
DataSourceView メンバ
System.Web.UI 名前空間
CanUpdate