IDataAdapter.Update メソッド

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

Function Update( _
   ByVal dataSet As DataSet _) As Integer
[C#]
int Update(
   DataSetdataSet);
[C++]
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 および DataSet によるデータベースの更新 」を参照してください。

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 句に元の値を含めて、オプティミスティック同時実行違反をチェックするためによく使用されます。

使用例

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

 
Public Function CreateCmdsAndUpdate(myDataSet As DataSet, myConnection As String, mySelectQuery As String, myTableName As String) As DataSet
    Dim myConn As New OleDbConnection(myConnection)
    Dim myDataAdapter As New OleDbDataAdapter()
    myDataAdapter.SelectCommand = New OleDbCommand(mySelectQuery, myConn)
    Dim custCB As OleDbCommandBuilder = New OleDbCommandBuilder(myDataAdapter)

    myConn.Open()

    Dim custDS As DataSet = New DataSet
    myDataAdapter.Fill(custDS)

    ' Code to modify data in DataSet here 

    ' Without the OleDbCommandBuilder this line would fail.
    myDataAdapter.Update(custDS)

    myConn.Close()

    CreateCmdsAndUpdate = custDS
End Function 'SelectOleDbSrvRows

[C#] 
public DataSet CreateCmdsAndUpdate(DataSet myDataSet,string myConnection,string mySelectQuery,string myTableName) 
{
    OleDbConnection myConn = new OleDbConnection(myConnection);
    OleDbDataAdapter myDataAdapter = new OleDbDataAdapter();
    myDataAdapter.SelectCommand = new OleDbCommand(mySelectQuery, myConn);
    OleDbCommandBuilder custCB = new OleDbCommandBuilder(myDataAdapter);

    myConn.Open();

    DataSet custDS = new DataSet();
    myDataAdapter.Fill(custDS);

    //code to modify data in dataset here

    //Without the OleDbCommandBuilder this line would fail
    myDataAdapter.Update(custDS);

    myConn.Close();

    return custDS;
 }

[C++] 
public:
DataSet* CreateCmdsAndUpdate(DataSet* /*myDataSet*/,String* myConnection,String* mySelectQuery,String* /*myTableName*/) 
{
    OleDbConnection* myConn = new OleDbConnection(myConnection);
    OleDbDataAdapter* myDataAdapter = new OleDbDataAdapter();
    myDataAdapter->SelectCommand = new OleDbCommand(mySelectQuery, myConn);
    OleDbCommandBuilder* custCB = new OleDbCommandBuilder(myDataAdapter);

    myConn->Open();

    DataSet* custDS = new DataSet();
    myDataAdapter->Fill(custDS);

    //code to modify data in dataset here

    //Without the OleDbCommandBuilder this line would fail
    myDataAdapter->Update(custDS);

    myConn->Close();

    return custDS;
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

IDataAdapter インターフェイス | IDataAdapter メンバ | System.Data 名前空間