SqlDataSourceView.ExecuteUpdate メソッドとは何？わかりやすく解説 Weblio辞書

索引トップ用語の索引ランキング

SqlDataSourceView.ExecuteUpdate メソッド

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

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

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

Visual Basic (宣言)

Protected Overrides 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)

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

C++

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

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

JScript

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

パラメータ

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

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

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

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

例外

例外の種類	条件
InvalidOperationException	SqlDataSource が、基になるデータソースとの接続を確立できません。または ConflictDetection プロパティが CompareAllValues 値に設定され、oldValues パラメータが渡されていません。
HttpException	現在のユーザーには、データベースにアクセスできる正しいアクセス許可がありません。
NotSupportedException	CanUpdate プロパティが false です。

例外の種類

条件

InvalidOperationException

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

または

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

HttpException

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

NotSupportedException

CanUpdate プロパティが false です。

解説

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