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

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

UpdateCommand SQL 文字列、UpdateParameters コレクション内の任意のパラメーター、および指定した keys、values、oldValues の各コレクション内の値を使用して、更新操作を実行します。

protected:
 override int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);
protected override int ExecuteUpdate (System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
Protected Overrides Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

パラメーター

keys
IDictionary

データベース更新操作を実行するために、IDictionary プロパティで使用する主キーの UpdateCommand。 クエリに関連付けられているキーがないか、UpdateCommand プロパティがパラメーター化された SQL クエリでない場合は、null を渡します。

values
IDictionary

データベース更新操作を実行するために、IDictionary プロパティで使用する値の UpdateCommand。 クエリに関連付けられているパラメーターがないか、UpdateCommand がパラメーター化された SQL クエリでない場合は、null を渡します。

oldValues
IDictionary

データベース内の元の値を表す IDictionary。 クエリに関連付けられているパラメーターがないか、UpdateCommand プロパティがパラメーター化された SQL クエリでない場合は、null を渡します。

戻り値

Int32

基になるデータベースで更新された行数を表す値。

例外

InvalidOperationException

SqlDataSource が、基になるデータ ソースとの接続を確立できません。

- または -

ConflictDetection プロパティが CompareAllValues 値に設定され、oldValues パラメーターが渡されていません。

HttpException

現在のユーザーには、データベースにアクセスできる正しいアクセス許可がありません。

NotSupportedException

CanUpdate プロパティが false です。

注釈

クラスは SqlDataSourceView 、継承された ExecuteUpdate メソッドを実装して、データベース内のデータを更新します。 ページ開発者とデータ バインド コントロールの作成者は、 メソッドを ExecuteUpdate 直接呼び出しません。代わりに、公開されている Update メソッドを使用します。

コレクションと values コレクションにkeys含まれる値は評価され、コレクションに含まれるすべての値とUpdateParametersマージされます。 プロパティが ConflictDetection に CompareAllValues設定されている場合、コレクションに oldValues 含まれる値は で OldValuesParameterFormatString 書式設定され、マージも行われます。

更新操作が実行される前に、 メソッドが OnUpdating 呼び出されてイベントが発生します Updating 。 このイベントを処理して、パラメーターの値を調べ、更新前に前処理を実行できます。

操作を実行するために、SqlDataSourceViewテキストと関連UpdateParametersするプロパティを使用して オブジェクトをUpdateCommandビルドDbCommandし、基になるデータベースにDbCommand対して オブジェクトを実行します。 操作が完了すると、 OnUpdated メソッドが呼び出されてイベントが発生します Updated 。 このイベントを処理して、戻り値とエラー コードを調べ、後処理を実行できます。

適用対象

こちらもご覧ください