LinqDataSourceUpdateEventArgs Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan data untuk peristiwa tersebut Updating .
public ref class LinqDataSourceUpdateEventArgs : System::ComponentModel::CancelEventArgs
public class LinqDataSourceUpdateEventArgs : System.ComponentModel.CancelEventArgs
type LinqDataSourceUpdateEventArgs = class
inherit CancelEventArgs
Public Class LinqDataSourceUpdateEventArgs
Inherits CancelEventArgs
- Warisan
Contoh
Contoh berikut menunjukkan penanganan aktivitas untuk peristiwa tersebut Updating . Contoh menunjukkan cara membandingkan properti dari OriginalObject properti dan NewObject properti untuk menentukan apakah nilai dalam Category
properti telah berubah. Jika demikian, CategoryChanged
properti objek dalam NewObject properti diatur ke true
.
protected void LinqDataSource_Updating(object sender, LinqDataSourceUpdateEventArgs e)
{
Product originalProduct = (Product)e.OriginalObject;
Product newProduct = (Product)e.NewObject;
if (originalProduct.Category != newProduct.Category)
{
newProduct.CategoryChanged = true;
}
}
Protected Sub LinqDataSource_Updating(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceUpdateEventArgs)
Dim originalProduct As Product
Dim newProduct As Product
originalProduct = CType(e.OriginalObject, Product)
newProduct = CType(e.NewObject, Product)
If (originalProduct.Category <> newProduct.Category) Then
newProduct.CategoryChanged = True
End If
End Sub
Contoh berikut menunjukkan penanganan aktivitas untuk peristiwa tersebut Updating . Ini menampilkan pesan pengecualian validasi dengan menggunakan Label kontrol.
Protected Sub LinqDataSource_Updating(ByVal sender As Object, _
ByVal e As LinqDataSourceUpdateEventArgs)
If (e.Exception IsNot Nothing) Then
For Each innerException As KeyValuePair(Of String, Exception) _
In e.Exception.InnerExceptions
Label1.Text &= innerException.Key & ": " & _
innerException.Value.Message & "<br />"
Next
e.ExceptionHandled = True
End If
End Sub
protected void LinqDataSource_Updating(object sender,
LinqDataSourceUpdateEventArgs e)
{
if (e.Exception != null)
{
foreach (KeyValuePair<string, Exception> innerException in
e.Exception.InnerExceptions)
{
Label1.Text += innerException.Key + ": " +
innerException.Value.Message + "<br />";
}
e.ExceptionHandled = true;
}
}
Keterangan
Objek LinqDataSourceUpdateEventArgs diteruskan ke penanganan aktivitas apa pun untuk peristiwa tersebut Updating . Anda dapat menggunakan LinqDataSourceUpdateEventArgs objek untuk memeriksa data sebelum operasi pembaruan dijalankan di sumber data. Anda kemudian dapat memvalidasi data, memeriksa pengecualian validasi yang dilemparkan oleh kelas data, atau mengubah nilai sebelum pembaruan. Anda juga dapat membatalkan operasi pembaruan.
Objek OriginalObject berisi data yang awalnya diambil dari sumber data. Objek NewObject berisi data yang akan disimpan di sumber data selama operasi pembaruan.
Jika objek yang mewakili sumber data melemparkan pengecualian validasi sebelum memperbarui data, Exception properti berisi instans LinqDataSourceValidationException kelas . Anda dapat mengambil semua pengecualian validasi melalui InnerExceptions properti . Jika tidak ada pengecualian validasi yang dilemparkan, Exception properti berisi null
. Jika Anda menangani pengecualian validasi dan tidak ingin pengecualian dilemparkan kembali, atur ExceptionHandled properti ke true
.
Secara default, LinqDataSource kontrol menyimpan nilai asli dari sumber data dalam status tampilan di halaman Web, kecuali yang atributnya ColumnAttribute ditandai sebagai UpdateCheck.Never
. LINQ ke SQL secara otomatis memeriksa integritas data sebelum memperbarui data. Ini dilakukan dengan membandingkan nilai saat ini di sumber data dengan nilai asli yang disimpan dalam status tampilan. LINQ ke SQL menimbulkan pengecualian jika nilai dalam sumber data telah berubah. Anda dapat melakukan validasi data tambahan dengan membuat handler untuk peristiwa tersebut Updating .
Konstruktor
LinqDataSourceUpdateEventArgs(LinqDataSourceValidationException) |
Menginisialisasi instans LinqDataSourceUpdateEventArgs baru kelas dengan pengecualian yang ditentukan. |
LinqDataSourceUpdateEventArgs(Object, Object) |
Menginisialisasi instans baru kelas LinqDataSourceUpdateEventArgs. |
Properti
Cancel |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah acara harus dibatalkan. (Diperoleh dari CancelEventArgs) |
Exception |
Mendapatkan pengecualian yang dilemparkan saat data sedang divalidasi sebelum operasi pembaruan. |
ExceptionHandled |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengecualian ditangani dan tidak boleh dilemparkan lagi. |
NewObject |
Mendapatkan objek yang berisi nilai yang akan disimpan di sumber data. |
OriginalObject |
Mendapatkan objek yang berisi nilai yang awalnya diambil dari sumber data. |
Metode
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |