LinqDataSourceUpdateEventArgs Kelas

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.Extensions.dll

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

Object

EventArgs

CancelEventArgs

LinqDataSourceUpdateEventArgs

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)

Lihat juga

• LINQ ke SQL