IDataAdapter.Update メソッド

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

IDataAdapter.Update メソッド

指定された DataSet 内の Table という名前の DataTable に含まれる挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Function Update ( _
    dataSet As DataSet _
) As Integer

Visual Basic (使用法)

Dim instance As IDataAdapter
Dim dataSet As DataSet
Dim returnValue As Integer

returnValue = instance.Update(dataSet)

C#

int Update (
    DataSet dataSet
)

C++

int Update (
    DataSet^ dataSet
)

J#

int Update (
    DataSet dataSet
)

JScript

function Update (
    dataSet : DataSet
) : int

パラメータ

dataSet

データ ソースの更新に使用した DataSet。

戻り値
DataSet 内で正常に更新された行の数。

例外

例外の種類	条件
DBConcurrencyException	INSERT、UPDATE、DELETE の各ステートメントを実行しようとしましたが、影響を受けたレコードはありませんでした。

解説

アプリケーションが Update メソッドを呼び出すと、IDataAdapter は、RowState プロパティを調べ、DataSet に設定されているインデックスの順序に基づいて、要求された INSERT、UPDATE、または DELETE ステートメントを各行に対して反復的に実行します。たとえば、Update が呼び出されたときに、DataTable 内の行の順序に応じて、DELETE ステートメントを実行し、INSERT ステートメントを実行してから、別の DELETE ステートメントを実行することなどがあります。

これらのステートメントはバッチ処理として実行されるのではない点に注意してください。各行は個別に更新されます。UPDATE の前に INSERT を実行するなど、ステートメントの種類のシーケンスを制御する必要がある場合は、アプリケーションから GetChanges メソッドを呼び出すことができます。詳細については、「DataAdapter によるデータ ソースの更新」を参照してください。

INSERT、UPDATE または DELETE ステートメントが指定されていない場合、Update メソッドでは、例外が生成されます。ただし、.NET Framework データ プロバイダの SelectCommand プロパティを設定した場合は、単一テーブルを更新する SQL ステートメントを自動的に生成する SqlCommandBuilder または OleDbCommandBuilder オブジェクトを作成できます。これによって、追加の SQL ステートメントが、CommandBuilder によって自動的に生成されます。この生成ロジックでは、DataSet 内にキー列情報が存在している必要があります。詳細については、「コマンドの自動生成」を参照してください。

Update メソッドは、更新の実行前の最初のマップに示されたテーブルから行を取得します。次に Update は、UpdatedRowSource プロパティの値を使用して行を更新します。返された追加の行はすべて無視されます。

DataSet にデータが戻されるたびに、OnRowUpdated イベントが発生します。これによって、ユーザーは、DataSet の調整済みの行、およびコマンドによって返された出力パラメータを検査できます。行が正常に更新されると、その行に対する変更が受け入れられます。

Update を使用するときは、次の順序で処理が実行されます。

1. DataRow 内の値が、パラメータ値に移動されます。

2. OnRowUpdating イベントが発生します。

3. コマンドが実行されます。

4. コマンドが FirstReturnedRecord に設定されている場合は、最初に返された結果が DataRow に格納されます。

5. 出力パラメータがある場合は、それが DataRow に格納されます。

6. OnRowUpdated イベントが発生します。

7. AcceptChanges が呼び出されます。

IDataAdapter に関連付けられた各コマンドには、通常、パラメータ コレクションが関連付けられています。パラメータは、.NET Framework データ プロバイダの Parameter クラスの SourceColumn プロパティおよび SourceVersion プロパティを通じて現在の行に割り当てられます。SourceColumn は、IDataAdapter が現在の行のパラメータ値を取得するために参照する DataTable 列を参照します。

テーブル マップが適用される前は、SourceColumn は、割り当てられていない列名を参照します。SourceColumn が参照する列が存在しない場合、実行されるアクションは次の MissingMappingAction 値によって異なります。

列挙値	アクション
MissingMappingAction.Passthrough	マップが存在しない場合は、DataSet 内のソース列名およびテーブル名が使用されます。
MissingMappingAction.Ignore	SystemException が生成されます。マップが明示的に設定された場合、入力パラメータに関してマップが存在しないときは、通常、エラーになります。
MissingMappingAction.Error	SystemException が生成されます。

SourceColumn プロパティは、マップを通じて出力パラメータまたは入出力パラメータの値を DataSet に戻すときにも使用されます。存在しない列を参照している場合は、例外が生成されます。

.NET Framework データ プロバイダの Parameter クラスの SourceVersion プロパティは、Original、Current、または Proposed のどのバージョンの列値を使用するかを指定します。この機能は、UPDATE ステートメントの WHERE 句に元の値を含めて、オプティミスティック同時実行違反をチェックするためによく使用されます。

メモ
行の更新時にエラーが発生した場合は、例外がスローされ、更新の実行が中断されます。エラーが発生しても例外を生成せずに更新操作を続けるには、Update を呼び出す前に、ContinueUpdateOnError プロパティを true に設定します。DataAdapter の RowUpdated イベント内で、行単位でエラーに対応することもできます。RowUpdated イベント内で例外を生成せずに更新操作を続けるには、RowUpdatedEventArgs の Status プロパティを Continue に設定します。

使用例

OleDbDataAdapter 派生クラスを使用して、データ ソースに Update を実行する例を次に示します。この例では、OleDbDataAdapter および DataSet が作成されていることを前提にしています。

Visual Basic

Public Function CreateCommandAndUpdate( _
    ByVal connectionString As String,
 _
    ByVal queryString As String)
 As DataSet

    Dim dataSet As DataSet = New
 DataSet

    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim dataAdapter As New
 OleDbDataAdapter()

        dataAdapter.SelectCommand = New OleDbCommand( _
            queryString, connection)

        Dim commandBuilder As OleDbCommandBuilder
 = _
            New OleDbCommandBuilder(dataAdapter)

        dataAdapter.Fill(dataSet)

        ' Code to modify the data in the DataSet here. 

        ' Without the OleDbCommandBuilder this line would fail.
        dataAdapter.Update(dataSet)
    End Using
    CreateCommandAndUpdate = dataSet
End Function

C#

static private DataSet CreateCommandAndUpdate(
    string connectionString,
    string queryString)
{
    DataSet dataSet = new DataSet();

    using (OleDbConnection connection =
               new OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbDataAdapter dataAdapter =
            new OleDbDataAdapter();
        dataAdapter.SelectCommand =
            new OleDbCommand(queryString, connection);
        OleDbCommandBuilder commandBuilder =
            new OleDbCommandBuilder(dataAdapter);

        dataAdapter.Fill(dataSet);

        // Code to modify data in the DataSet here.

        //Without the OleDbCommandBuilder this line would fail.
        dataAdapter.Update(dataSet);
    }
    return dataSet;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
IDataAdapter インターフェイス
IDataAdapter メンバ
System.Data 名前空間