LinqDataSourceUpdateEventArgs Sınıf

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.Extensions.dll

Updating olayı için veriler sağlar.

public ref class LinqDataSourceUpdateEventArgs : System::ComponentModel::CancelEventArgs

public class LinqDataSourceUpdateEventArgs : System.ComponentModel.CancelEventArgs

type LinqDataSourceUpdateEventArgs = class
    inherit CancelEventArgs

Public Class LinqDataSourceUpdateEventArgs
Inherits CancelEventArgs

Devralma

Object

EventArgs

CancelEventArgs

LinqDataSourceUpdateEventArgs

Örnekler

Aşağıdaki örnekte olay için bir olay işleyicisi gösterilmektedir Updating . Örnekte, özellikteki değerin OriginalObject değişip değişmediğini belirlemek için özelliğinden ve NewObject özelliğinden özelliklerin Category nasıl karşılaştırıldığını gösterir. Bu durumda, CategoryChanged özelliğindeki NewObject nesnesinin özelliği olarak trueayarlanır.

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

Aşağıdaki örnekte olay için bir olay işleyicisi gösterilmektedir Updating . Denetim kullanarak Label tüm doğrulama özel durum iletilerini görüntüler.

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;  
    }  
}  

Açıklamalar

LinqDataSourceUpdateEventArgs nesnesi, olay için herhangi bir olay işleyicisine Updating geçirilir. Veri kaynağında LinqDataSourceUpdateEventArgs güncelleştirme işlemi yürütülmeden önce verileri incelemek için nesnesini kullanabilirsiniz. Ardından verileri doğrulayabilir, veri sınıfı tarafından oluşan doğrulama özel durumlarını inceleyebilir veya güncelleştirmeden önce bir değeri değiştirebilirsiniz. Güncelleştirme işlemini de iptal edebilirsiniz.

OriginalObject nesnesi, başlangıçta veri kaynağından alınan verileri içerir. nesnesi, NewObject güncelleştirme işlemi sırasında veri kaynağına kaydedilecek verileri içerir.

Veri kaynağını temsil eden nesne, verileri güncelleştirmeden önce bir doğrulama özel durumu oluşturursa, Exception özelliği sınıfının bir örneğini LinqDataSourceValidationException içerir. Tüm doğrulama özel durumlarını özelliği aracılığıyla InnerExceptions alabilirsiniz. Hiçbir doğrulama özel durumu oluşturulursa özelliği Exception içerir null. Doğrulama özel durumlarını işlerseniz ve özel durumun yeniden oluşturulmasını istemiyorsanız özelliğini olarak trueayarlayınExceptionHandled.

Varsayılan olarak, LinqDataSource özniteliği olarak UpdateCheck.Neverişaretlenmiş olanlar ColumnAttribute dışında denetim, veri kaynağındaki özgün değerleri Web sayfasındaki görünüm durumunda depolar. LINQ to SQL, verileri güncelleştirmeden önce verilerin bütünlüğünü otomatik olarak denetler. Bunu, veri kaynağındaki geçerli değerleri görünüm durumunda depolanan özgün değerlerle karşılaştırarak yapar. LINQ to SQL, veri kaynağındaki değerler değiştiyse bir özel durum oluşturur. Olay için Updating bir işleyici oluşturarak ek veri doğrulama gerçekleştirebilirsiniz.

Oluşturucular

LinqDataSourceUpdateEventArgs(LinqDataSourceValidationException)	Belirtilen özel durumla sınıfının yeni bir örneğini LinqDataSourceUpdateEventArgs başlatır.
LinqDataSourceUpdateEventArgs(Object, Object)	LinqDataSourceUpdateEventArgs sınıfının yeni bir örneğini başlatır.

Özellikler

Cancel	Olayın iptal edilip edilmeyeceğini belirten bir değer alır veya ayarlar. (Devralındığı yer: CancelEventArgs)
Exception	Güncelleştirme işleminden önce veriler doğrulanırken oluşan özel durumu alır.
ExceptionHandled	Özel durumun işlenip işlenmediğini ve yeniden oluşturulmayacağını belirten bir değer alır veya ayarlar.
NewObject	Veri kaynağına kaydedilecek değerleri içeren nesneyi alır.
OriginalObject	Başlangıçta veri kaynağından alınan değerleri içeren nesneyi alır.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• LINQ to SQL