DbDataAdapter.Updateとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

DbDataAdapter.Update メソッド (DataRow[], DataTableMapping)

指定した DataRow オブジェクト配列内の挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

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

Visual Basic (宣言)
Protected Overridable Function
 Update ( _
    dataRows As DataRow(), _
    tableMapping As DataTableMapping _
) As Integer
Visual Basic (使用法)
Dim dataRows As DataRow()
Dim tableMapping As DataTableMapping
Dim returnValue As Integer

returnValue = Me.Update(dataRows, tableMapping)
C#
protected virtual int Update (
    DataRow[] dataRows,
    DataTableMapping tableMapping
)
C++
protected:
virtual int Update (
    array<DataRow^>^ dataRows, 
    DataTableMapping^ tableMapping
)
J#
protected int Update (
    DataRow[] dataRows, 
    DataTableMapping tableMapping
)
JScript
protected function Update (
    dataRows : DataRow[], 
    tableMapping : DataTableMapping
) : int

パラメータ

dataRows

データ ソースの更新に使用する DataRow オブジェクトの配列。

tableMapping

使用する TableMappings コレクション。

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

例外例外
例外の種類条件

ArgumentNullException

DataSet が無効です。

InvalidOperationException

ソース テーブルが無効です。

SystemException

更新する DataRow が存在しません。

または

更新する DataTable が存在しません。

または

ソースとして使用する DataSet が存在しません。

DBConcurrencyException

INSERT ステートメント、UPDATE ステートメント、または DELETE ステートメントを実行しようとしましたが、影響を受けたレコードはありませんでした。

解説解説

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

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

プラットフォームプラットフォーム

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
参照参照
関連項目
DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間

DbDataAdapter.Update メソッド (DataRow[])

指定した DataRow オブジェクト配列内の挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

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

Visual Basic (宣言)
Public Function Update ( _
    dataRows As DataRow() _
) As Integer
Visual Basic (使用法)
Dim instance As DbDataAdapter
Dim dataRows As DataRow()
Dim returnValue As Integer

returnValue = instance.Update(dataRows)
C#
public int Update (
    DataRow[] dataRows
)
C++
public:
int Update (
    array<DataRow^>^ dataRows
)
J#
public int Update (
    DataRow[] dataRows
)
JScript
public function Update (
    dataRows : DataRow[]
) : int

パラメータ

dataRows

データ ソースの更新に使用する DataRow オブジェクトの配列。

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

例外例外
例外の種類条件

ArgumentNullException

DataSet が無効です。

InvalidOperationException

ソース テーブルが無効です。

SystemException

更新する DataRow が存在しません。

または

更新する DataTable が存在しません。

または

ソースとして使用する DataSet が存在しません。

DBConcurrencyException

INSERT ステートメント、UPDATE ステートメント、または DELETE ステートメントを実行しようとしましたが、影響を受けたレコードはありませんでした。

解説解説

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

DbDataAdapter に関連付けられた各コマンドには、通常、パラメータ コレクションが関連付けられています。パラメータは、.NET Framework データ プロバイダの Parameter クラスの SourceColumn プロパティおよび SourceVersion プロパティを通じて現在の行に割り当てられます。SourceColumn は、DbDataAdapter が現在の行のパラメータ値を取得するために参照する 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 派生クラスを使用して、データ ソースを更新する例を次に示します。

Visual Basic
Public Function CreateCmdsAndUpdate(ByVal
 dataSet As DataSet, _
ByVal connectionString As String,
 ByVal queryString As String)
 As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New
 OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString,
 connection)
        Dim builder As OleDbCommandBuilder
 = New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As DataSet = New
 DataSet
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        ' Insert new records from DataSet
        Dim rows() As DataRow = customers.Tables(0).Select(
 _
            Nothing, Nothing, DataViewRowState.Added)
        adapter.Update(rows)

        Return customers
    End Using
End Function
C#
public DataSet CreateCmdsAndUpdate(DataSet dataSet, string
 connectionString,
    string queryString) 
{
    using (OleDbConnection connection = new
 OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString,
 connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        //Insert new records from DataSet
        DataRow[] rows = customers.Tables[0].Select(
            null, null, DataViewRowState.Added);
        adapter.Update(rows);

        return customers;
    }
}
プラットフォームプラットフォーム

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
参照参照
関連項目
DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間

DbDataAdapter.Update メソッド (DataSet, String)

指定した DataTable 名を使用して、DataSet 内の挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

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

Visual Basic (宣言)
Public Function Update ( _
    dataSet As DataSet, _
    srcTable As String _
) As Integer
Visual Basic (使用法)
Dim instance As DbDataAdapter
Dim dataSet As DataSet
Dim srcTable As String
Dim returnValue As Integer

returnValue = instance.Update(dataSet, srcTable)
C#
public int Update (
    DataSet dataSet,
    string srcTable
)
C++
public:
int Update (
    DataSet^ dataSet, 
    String^ srcTable
)
J#
public int Update (
    DataSet dataSet, 
    String srcTable
)
JScript
public function Update (
    dataSet : DataSet, 
    srcTable : String
) : int

パラメータ

dataSet

データ ソースの更新に使用する DataSet。

srcTable

テーブル マップに使用するソース テーブルの名前。

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

例外例外
例外の種類条件

ArgumentNullException

DataSet が無効です。

InvalidOperationException

ソース テーブルが無効です。

DBConcurrencyException

INSERT ステートメント、UPDATE ステートメント、または DELETE ステートメントを実行しようとしましたが、影響を受けたレコードはありませんでした。

解説解説

アプリケーションが Update メソッドを呼び出すと、DbDataAdapter は、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 メソッドは、大文字と小文字の違いを除いて名前が一致する DataTable オブジェクトが DataSet 内に複数含まれる場合に、それらを区別します。このようなテーブルが DataSet 内に複数存在する場合、Update は、大文字と小文字を区別して比較を実行し、対応するテーブルを見つけます。正確に一致するテーブルが存在しない場合は、例外を生成します。この動作を表す C# コードの例を次に示します。

DataSet ds = new DataSet();
 ds.Tables.Add("aaa");
 ds.Tables.Add("AAA");
 adapter.Update(ds, "aaa"); // Updates "aaa", which already exists in the DataSet.
 adapter.Update(ds, "AAA"); // Updates "AAA", which already exists in the DataSet.
    adapter.Update(ds, "Aaa"); // Results in an exception.

Update を呼び出したときに、大文字と小文字の違いを除いて名前が一致する DataTable が DataSet 内に 1 つだけ含まれている場合は、その DataTable が更新されます。この場合は、比較のときに大文字と小文字が区別されません。この動作を表す C# コードの例を次に示します。

DataSet dataset = new DataSet();
 dataset.Tables.Add("aaa");
    adapter.Update(dataset, "AAA"); // Updates table "aaa" because only one similarly
 named table is in the DataSet.

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

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

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

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

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

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

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

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

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

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

DbDataAdapter に関連付けられた各コマンドには、通常、パラメータ コレクションが関連付けられています。パラメータは、.NET Framework データ プロバイダの Parameter クラスの SourceColumn プロパティおよび SourceVersion プロパティを通じて現在の行に割り当てられます。SourceColumn は、DbDataAdapter が現在の行のパラメータ値を取得するために参照する 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 派生クラスを使用して、データ ソースを更新する例を次に示します。

Visual Basic
Public Function CreateCmdsAndUpdate(ByVal
 dataSet As DataSet, _
    ByVal connectionString As String,
 ByVal queryString As String,
 _
    ByVal tableName As String)
 As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New
 OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString,
 connection)
        Dim builder As OleDbCommandBuilder
 = New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As DataSet = New
 DataSet
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        adapter.Update(customers, tableName)

        Return customers
    End Using
End Function
C#
public DataSet CreateCmdsAndUpdate(DataSet dataSet, string
 connectionString,
    string queryString, string tableName) 
{
    using (OleDbConnection connection = new
 OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString,
 connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        adapter.Update(customers, tableName);

        return customers;
    }
}
プラットフォームプラットフォーム

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
参照参照
関連項目
DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間

DbDataAdapter.Update メソッド (DataSet)

指定した DataSet 内の挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

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

Visual Basic (宣言)
Public Overrides Function
 Update ( _
    dataSet As DataSet _
) As Integer
Visual Basic (使用法)
Dim instance As DbDataAdapter
Dim dataSet As DataSet
Dim returnValue As Integer

returnValue = instance.Update(dataSet)
C#
public override int Update (
    DataSet dataSet
)
C++
public:
virtual int Update (
    DataSet^ dataSet
) override
J#
public int Update (
    DataSet dataSet
)
JScript
public override function Update (
    dataSet : DataSet
) : int

パラメータ

dataSet

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

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

例外例外
例外の種類条件

InvalidOperationException

ソース テーブルが無効です。

DBConcurrencyException

INSERT ステートメント、UPDATE ステートメント、または DELETE ステートメントを実行しようとしましたが、影響を受けたレコードはありませんでした。

解説解説

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

DbDataAdapter に関連付けられた各コマンドには、通常、パラメータ コレクションが関連付けられています。パラメータは、.NET Framework データ プロバイダの Parameter クラスの SourceColumn プロパティおよび SourceVersion プロパティを通じて現在の行に割り当てられます。SourceColumn は、DbDataAdapter が現在の行のパラメータ値を取得するために参照する 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 派生クラスを使用して、データ ソースを更新する例を次に示します。

Visual Basic
Public Function CreateCmdsAndUpdate(ByVal
 dataSet As DataSet, _
ByVal connectionString As String,
 ByVal queryString As String)
 As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New
 OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString,
 connection)
        Dim builder As OleDbCommandBuilder
 = New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As DataSet = New
 DataSet
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        adapter.Update(customers)

        Return customers
    End Using
End Function
C#
public DataSet CreateCmdsAndUpdate(DataSet dataSet, string
 connectionString,
    string queryString) 
{
    using (OleDbConnection connection = new
 OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString,
 connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        adapter.Update(customers);

        return customers;
    }
}
プラットフォームプラットフォーム

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
参照参照
関連項目
DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間

DbDataAdapter.Update メソッド

DataSet 内の挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
DbDataAdapter.Update (DataRow[]) 指定した DataRow オブジェクト配列内の挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

.NET Compact Framework によってサポートされています。

DbDataAdapter.Update (DataSet) 指定した DataSet 内の挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

.NET Compact Framework によってサポートされています。

DbDataAdapter.Update (DataTable) 指定した DataTable 内の挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

.NET Compact Framework によってサポートされています。

DbDataAdapter.Update (DataRow[], DataTableMapping) 指定した DataRow オブジェクト配列内の挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

.NET Compact Framework によってサポートされています。

DbDataAdapter.Update (DataSet, String) 指定した DataTable 名を使用して、DataSet 内の挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

.NET Compact Framework によってサポートされています。

参照参照

関連項目

DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間

DbDataAdapter.Update メソッド (DataTable)

指定した DataTable 内の挿入行、更新行、または削除行に対して、INSERT、UPDATE、または DELETE ステートメントを個別に呼び出します。

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

Visual Basic (宣言)
Public Function Update ( _
    dataTable As DataTable _
) As Integer
Visual Basic (使用法)
Dim instance As DbDataAdapter
Dim dataTable As DataTable
Dim returnValue As Integer

returnValue = instance.Update(dataTable)
C#
public int Update (
    DataTable dataTable
)
C++
public:
int Update (
    DataTable^ dataTable
)
J#
public int Update (
    DataTable dataTable
)
JScript
public function Update (
    dataTable : DataTable
) : int

パラメータ

dataTable

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

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

例外例外
例外の種類条件

ArgumentNullException

DataSet が無効です。

InvalidOperationException

ソース テーブルが無効です。

SystemException

更新する DataRow が存在しません。

または

更新する DataTable が存在しません。

または

ソースとして使用する DataSet が存在しません。

DBConcurrencyException

INSERT ステートメント、UPDATE ステートメント、または DELETE ステートメントを実行しようとしましたが、影響を受けたレコードはありませんでした。

解説解説

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

DbDataAdapter に関連付けられた各コマンドには、通常、パラメータ コレクションが関連付けられています。パラメータは、.NET Framework データ プロバイダの Parameter クラスの SourceColumn プロパティおよび SourceVersion プロパティを通じて現在の行に割り当てられます。SourceColumn は、DbDataAdapter が現在の行のパラメータ値を取得するために参照する 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 派生クラスを使用して、データ ソースを更新する例を次に示します。

Visual Basic
Public Function CreateCmdsAndUpdate(ByVal
 dataSet As DataSet, _
ByVal connectionString As String,
 ByVal queryString As String)
 As DataSet

    Using connection As New OleDbConnection(connectionString)
        Dim adapter As New
 OleDbDataAdapter()
        adapter.SelectCommand = New OleDbCommand(queryString,
 connection)
        Dim builder As OleDbCommandBuilder
 = New OleDbCommandBuilder(adapter)

        connection.Open()

        Dim customers As DataSet = New
 DataSet
        adapter.Fill(customers)

        ' Code to modify data in DataSet here 

        adapter.Update(customers)
        Return customers
    End Using
End Function
C#
public DataSet CreateCmdsAndUpdate(DataSet dataSet, string
 connectionString,
    string queryString) 
{
    using (OleDbConnection connection = new
 OleDbConnection(connectionString))
    {
        OleDbDataAdapter adapter = new OleDbDataAdapter();
        adapter.SelectCommand = new OleDbCommand(queryString,
 connection);
        OleDbCommandBuilder builder = new OleDbCommandBuilder(adapter);

        connection.Open();

        DataSet customers = new DataSet();
        adapter.Fill(customers);

        //code to modify data in dataset here

        adapter.Update(customers);

        return customers;
    }
}
プラットフォームプラットフォーム

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
参照参照
関連項目
DbDataAdapter クラス
DbDataAdapter メンバ
System.Data.Common 名前空間

急上昇のことば

ジム・スタインマン
リポスト
かくかくしかじか
コミュニティ
リアルピース
このページでは「.NET Framework クラス ライブラリ リファレンス」からDbDataAdapter.Updateを検索した結果を表示しています。
Weblioに収録されているすべての辞書からDbDataAdapter.Updateを検索する場合は、下記のリンクをクリックしてください。
 全ての辞書からDbDataAdapter.Update を検索
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「DbDataAdapter.Update」の関連用語

1
DbDataAdapter.Update メソッド
.NET Framework クラス ライブラリ リファレンス
96% |||||

2
DataTable.AcceptChanges メソッド
.NET Framework クラス ライブラリ リファレンス
18% |||||

DbDataAdapter.Updateのお隣キーワード

DbDataAdapter.System.Data.IDbDataAdapter.DeleteCommand プロパティ

DbDataAdapter.System.Data.IDbDataAdapter.InsertCommand プロパティ

DbDataAdapter.System.Data.IDbDataAdapter.SelectCommand プロパティ

DbDataAdapter.System.Data.IDbDataAdapter.UpdateCommand プロパティ

DbDataAdapter.System.ICloneable.Clone メソッド

DbDataAdapter.TerminateBatching メソッド

DbDataAdapter.Update

DbDataAdapter.Update メソッド

DbDataAdapter.UpdateBatchSize プロパティ

DbDataAdapter.UpdateCommand プロパティ

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


DbDataAdapter.Updateのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2025 Microsoft.All rights reserved.

©2025 GRAS Group, Inc.RSS