DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary) Metode

Definisi

Ruang nama:

System.Web.UI

Rakitan:

System.Web.dll

Melakukan operasi pembaruan pada daftar data yang diwakili DataSourceView objek.

protected:
 virtual int ExecuteUpdate(System::Collections::IDictionary ^ keys, System::Collections::IDictionary ^ values, System::Collections::IDictionary ^ oldValues);

protected virtual int ExecuteUpdate(System.Collections.IDictionary keys, System.Collections.IDictionary values, System.Collections.IDictionary oldValues);

abstract member ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int
override this.ExecuteUpdate : System.Collections.IDictionary * System.Collections.IDictionary * System.Collections.IDictionary -> int

Protected Overridable Function ExecuteUpdate (keys As IDictionary, values As IDictionary, oldValues As IDictionary) As Integer

Parameter

keys

IDictionary

Kunci IDictionary objek atau baris yang akan diperbarui oleh operasi pembaruan.

values

IDictionary

Pasangan IDictionary nama/nilai yang mewakili elemen data dan nilai barunya.

oldValues

IDictionary

Pasangan IDictionary nama/nilai yang mewakili elemen data dan nilai aslinya.

Mengembalikan

Int32

Jumlah item yang diperbarui dalam penyimpanan data yang mendasar.

Pengecualian

NotSupportedException

ExecuteUpdate(IDictionary, IDictionary, IDictionary) Operasi ini tidak didukung oleh DataSourceView.

Contoh

Contoh kode berikut menunjukkan bagaimana kelas yang memperluas DataSourceView kelas dapat mengambil alih CanUpdate properti dan ExecuteUpdate metode . Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk DataSourceView kelas .

// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
    get {
        return false;
    }
}
protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
{
    throw new NotSupportedException();
}

   ' The CsvDataSourceView does not currently
   ' permit update operations. You can modify or
   ' extend this sample to do so.
   Public Overrides ReadOnly Property CanUpdate() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
                                              values As IDictionary, _
                                              oldValues As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteUpdate

End Class

Keterangan

Kontrol terikat data dapat menentukan apakah ExecuteUpdate operasi didukung oleh kontrol sumber data dengan menggunakan DataSourceControl.GetView metode untuk mengambil DataSourceView objek dan memeriksa nilai CanUpdate properti.

Parameter keys mewakili kunci objek atau baris data yang akan diperbarui. Untuk sumber data yang mewakili data relasional, seperti SqlDataSource kontrol, keys parameter adalah kumpulan kunci primer database. Dalam skenario lain, keys parameter adalah kumpulan pasangan nama/nilai dan digunakan untuk memfilter daftar data. Setiap data yang cocok dengan pasangan nama/nilai diperbarui dengan nilai yang ditemukan dalam values parameter, yang merupakan sekumpulan pasangan nama/nilai yang mewakili nilai baru untuk bidang atau kolom yang ada.

Nota

Implementasi DataSourceView default kelas adalah melemparkan NotSupportedException pengecualian. Jika Anda memperluas DataSourceView kelas, ambil alih ExecuteUpdate metode jika kelas Anda mendukung pembaruan data di penyimpanan data yang mendasar.

Lihat juga

• CanUpdate