DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) メソッド

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.dll

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

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

protected virtual int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);

abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int

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

パラメーター

keys

IDictionary

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

values

IDictionary

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

oldValues

IDictionary

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

戻り値

Int32

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

例外

NotSupportedException

ExecuteUpdate(IDictionary, IDictionary, IDictionary) 操作は DataSourceView ではサポートされません。

例

次のコード例は、 クラスを拡張するクラスが DataSourceView プロパティと メソッドを CanUpdate オーバーライドする方法を ExecuteUpdate 示しています。 このコード例は、DataSourceView クラスのために提供されている大規模な例の一部です。

// 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();
}

   ' 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

注釈

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

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

注意

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

こちらもご覧ください

• CanUpdate