DataAdapter.Update(DataSet) Metode

Definisi

Ruang nama:

System.Data.Common

Rakitan:

System.Data.Common.dll

Sumber:

DataAdapter.cs

Memanggil pernyataan INSERT, UPDATE, atau DELETE masing-masing untuk setiap baris yang disisipkan, diperbarui, atau dihapus dalam yang ditentukan DataSet dari DataTable "Tabel" bernama

public:
 virtual int Update(System::Data::DataSet ^ dataSet);

public virtual int Update (System.Data.DataSet dataSet);

abstract member Update : System.Data.DataSet -> int
override this.Update : System.Data.DataSet -> int

Public Overridable Function Update (dataSet As DataSet) As Integer

Parameter

dataSet

DataSet

yang DataSet digunakan untuk memperbarui sumber data.

Mengembalikan

Int32

Jumlah baris berhasil diperbarui dari DataSet.

Penerapan

Update(DataSet)

Pengecualian

InvalidOperationException

Tabel sumber tidak valid.

DBConcurrencyException

Upaya untuk menjalankan pernyataan INSERT, UPDATE, atau DELETE mengakibatkan tidak ada rekaman yang terpengaruh.

Contoh

Contoh berikut menggunakan kelas turunan, OleDbDataAdapter, ke Update sumber data.

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

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

        adapter.Fill(dataSet);

        // Code to modify data in the DataSet here.

        // Without the OleDbCommandBuilder, this line would fail.
        adapter.UpdateCommand = builder.GetUpdateCommand();
        adapter.Update(dataSet);
    }
    return dataSet;
}

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

    Dim dataSet As New DataSet()

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

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

        Dim builder As OleDbCommandBuilder = _
            New OleDbCommandBuilder(adapter)

        adapter.Fill(dataSet)

        ' Code to modify the data in the DataSet here. 

        ' Without the OleDbCommandBuilder this line would fail.
        builder.GetUpdateCommand()
        adapter.Update(dataSet)
    End Using
    Return dataSet
End Function

Keterangan

Pembaruan dilakukan berdasarkan baris demi baris. Untuk setiap baris yang disisipkan, dimodifikasi, dan dihapus, Update metode menentukan jenis perubahan yang telah dilakukan di atasnya (Sisipkan, Perbarui, atau Hapus). Bergantung pada jenis perubahan, Inserttemplat perintah , Update, atau Delete dijalankan untuk menyebarluaskan baris yang dimodifikasi ke sumber data. Saat aplikasi memanggil Update metode , DataAdapter aplikasi memeriksa RowState properti , dan menjalankan pernyataan INSERT, UPDATE, atau DELETE yang diperlukan secara berulang untuk setiap baris, berdasarkan urutan indeks yang dikonfigurasi di DataSet. Misalnya, Update mungkin menjalankan pernyataan DELETE, diikuti dengan pernyataan INSERT, lalu pernyataan DELETE lainnya, karena urutan baris di DataTable.

Perlu dicatat bahwa pernyataan-pernyataan ini tidak dilakukan sebagai proses batch; setiap baris diperbarui satu per satu. Aplikasi dapat memanggil GetChanges metode dalam situasi di mana Anda harus mengontrol urutan jenis pernyataan (misalnya, INSERT sebelum UPDATE). Untuk informasi selengkapnya, lihat Memperbarui Sumber Data dengan DataAdapters.

Jika pernyataan INSERT, UPDATE, atau DELETE belum ditentukan, Update metode menghasilkan pengecualian. Namun, Anda dapat membuat SqlCommandBuilder objek atau OleDbCommandBuilder untuk secara otomatis menghasilkan pernyataan SQL untuk pembaruan tabel tunggal jika Anda mengatur SelectCommand properti penyedia data .NET Framework. Kemudian, setiap pernyataan SQL tambahan yang tidak Anda tetapkan dihasilkan oleh CommandBuilder. Logika generasi ini memerlukan informasi kolom kunci untuk hadir di DataSet. Untuk informasi selengkapnya, lihat Membuat Perintah dengan CommandBuilders.

Metode ini Update mengambil baris dari tabel yang tercantum dalam pemetaan pertama sebelum melakukan pembaruan. kemudian Update merefresh baris menggunakan nilai UpdatedRowSource properti . Setiap baris tambahan yang dikembalikan diabaikan.

Setelah data dimuat kembali ke , DataSetOnRowUpdated peristiwa dinaikkan, memungkinkan pengguna untuk memeriksa baris yang direkonsiliasi DataSet dan parameter output apa pun yang dikembalikan oleh perintah . Setelah baris berhasil diperbarui, perubahan pada baris tersebut diterima.

Saat menggunakan Update, urutan eksekusi adalah sebagai berikut:

1. Nilai dalam DataRow dipindahkan ke nilai parameter.

2. Acara OnRowUpdating dinaikkan.

3. Perintah dijalankan.

4. Jika perintah diatur ke FirstReturnedRecord, maka hasil pertama yang dikembalikan ditempatkan di DataRow.

5. Jika ada parameter output, parameter tersebut ditempatkan di DataRow.

6. Acara OnRowUpdated dinaikkan.

7. DataRow.AcceptChanges dipanggil. Ini akan meningkatkan DataTable.RowChanging peristiwa dan DataTable.RowChanged untuk yang diperbarui DataRow.

Setiap perintah yang DataAdapter terkait dengan biasanya memiliki koleksi parameter yang terkait dengannya. Parameter dipetakan ke baris saat ini melalui SourceColumn properti dan SourceVersion kelas penyedia Parameter data .NET. SourceColumn mengacu pada DataTable kolom yang dirujuk DataAdapter untuk mendapatkan nilai parameter untuk baris saat ini.

SourceColumn mengacu pada nama kolom yang tidak dipetakan sebelum pemetaan tabel diterapkan. Jika SourceColumn merujuk ke kolom yang tidak ada, tindakan yang diambil bergantung pada salah satu nilai berikut MissingMappingAction .

Nilai enumerasi	Tindakan yang diambil
MissingMappingAction.Passthrough	Gunakan nama kolom sumber dan nama tabel dalam DataSet jika tidak ada pemetaan yang ada.
MissingMappingAction.Ignore	SystemException dihasilkan. Ketika pemetaan diatur secara eksplisit, pemetaan yang hilang untuk parameter input biasanya merupakan hasil dari kesalahan.
MissingMappingAction.Error	SystemException dihasilkan.

Properti SourceColumn juga digunakan untuk memetakan nilai untuk parameter output atau input/output kembali ke DataSet. Pengecualian dihasilkan jika mengacu pada kolom yang tidak ada.

Properti SourceVersion kelas penyedia Parameter data .NET menentukan apakah akan menggunakan versi Asli, Saat Ini, atau Usulan dari nilai kolom. Kemampuan ini sering digunakan untuk menyertakan nilai asli dalam klausa WHERE dari pernyataan UPDATE untuk memeriksa pelanggaran konkurensi optimis.

Memanggil AcceptChanges metode atau AcceptChanges metode akan melakukan semua perubahan di DataSet atau DataTable. Jika salah satu metode ini dipanggil sebelum Update metode dipanggil, tidak ada perubahan yang akan dilakukan ketika Update metode dipanggil, kecuali perubahan lebih lanjut telah dilakukan sejak AcceptChanges atau AcceptChanges dipanggil.

Catatan

Jika terjadi kesalahan saat memperbarui baris, pengecualian dilemparkan dan eksekusi pembaruan dihentikan. Untuk melanjutkan operasi pembaruan tanpa menghasilkan pengecualian saat terjadi kesalahan, atur ContinueUpdateOnError properti ke true sebelum memanggil Update. Anda juga dapat menanggapi kesalahan berdasarkan per baris jika RowUpdated terjadi DataAdapter. Untuk melanjutkan operasi pembaruan tanpa menghasilkan pengecualian dalam RowUpdated peristiwa, atur Status properti ke RowUpdatedEventArgsContinue.

Untuk setiap kolom yang Anda sebarkan ke sumber data pada Update, parameter harus ditambahkan ke InsertCommand, , UpdateCommandatau DeleteCommand. Properti SourceColumn parameter harus diatur ke nama kolom. Pengaturan ini menunjukkan bahwa nilai parameter tidak diatur secara manual, tetapi diambil dari kolom tertentu di baris yang saat ini diproses.

Lihat juga

• Ringkasan ADO.NET