DataAdapter.Update メソッド

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

DataAdapter.Update メソッド

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

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

Visual Basic (宣言)

Public Overridable Function
 Update ( _
    dataSet As DataSet _
) As Integer

Visual Basic (使用法)

Dim instance As DataAdapter
Dim dataSet As DataSet
Dim returnValue As Integer

returnValue = instance.Update(dataSet)

C#

public virtual int Update (
    DataSet dataSet
)

C++

public:
virtual int Update (
    DataSet^ dataSet
)

J#

public int Update (
    DataSet dataSet
)

JScript

public function Update (
    dataSet : DataSet
) : int

パラメータ

dataSet

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

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

例外

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

解説

アプリケーションが Update メソッドを呼び出すと、DataAdapter は、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 が呼び出されます。

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

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

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

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

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

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

使用例

OleDbDataAdapter 派生クラスを使用して、データ ソースに Update を実行する例を次に示します。

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

参照

関連項目
DataAdapter クラス
DataAdapter メンバ
System.Data.Common 名前空間