LinqDataSourceUpdateEventArgs Sınıf

Tanım

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
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)

Şunlara uygulanır

Ayrıca bkz.