LinqDataSourceUpdateEventArgs Classe

Definizione

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

public class LinqDataSourceUpdateEventArgs : System.ComponentModel.CancelEventArgs

type LinqDataSourceUpdateEventArgs = class
    inherit CancelEventArgs

Public Class LinqDataSourceUpdateEventArgs
Inherits CancelEventArgs

Ereditarietà

Object

EventArgs

CancelEventArgs

LinqDataSourceUpdateEventArgs

Esempio

Nell'esempio seguente viene illustrato un gestore eventi per l'evento Updating . Nell'esempio viene illustrato come confrontare le proprietà della OriginalObject proprietà e la NewObject proprietà per determinare se il valore nella Category proprietà è stato modificato. In tal caso, la CategoryChanged proprietà dell'oggetto nella NewObject proprietà è impostata su 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

Nell'esempio seguente viene illustrato un gestore eventi per l'evento Updating . Visualizza tutti i messaggi di eccezione di convalida usando un Label controllo .

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

Commenti

L'oggetto LinqDataSourceUpdateEventArgs viene passato a qualsiasi gestore eventi per l'evento Updating . È possibile utilizzare l'oggetto LinqDataSourceUpdateEventArgs per esaminare i dati prima dell'esecuzione dell'operazione di aggiornamento nell'origine dati. È quindi possibile convalidare i dati, esaminare le eccezioni di convalida generate dalla classe di dati o modificare un valore prima dell'aggiornamento. È anche possibile annullare l'operazione di aggiornamento.

L'oggetto OriginalObject contiene i dati originariamente recuperati dall'origine dati. L'oggetto NewObject contiene i dati che verranno salvati nell'origine dati durante l'operazione di aggiornamento.

Se l'oggetto che rappresenta l'origine dati genera un'eccezione di convalida prima di aggiornare i dati, la Exception proprietà contiene un'istanza della LinqDataSourceValidationException classe . È possibile recuperare tutte le eccezioni di convalida tramite la InnerExceptions proprietà . Se non viene generata alcuna eccezione di convalida, la Exception proprietà contiene null. Se si gestiscono le eccezioni di convalida e non si vuole che l'eccezione venga generata nuovamente, impostare la ExceptionHandled proprietà su true.

Per impostazione predefinita, il LinqDataSource controllo archivia i valori originali dell'origine dati nello stato di visualizzazione nella pagina Web, ad eccezione di quelli il cui ColumnAttribute attributo è contrassegnato come UpdateCheck.Never. LINQ to SQL controlla automaticamente l'integrità dei dati prima di aggiornare i dati. A tale scopo, confrontare i valori correnti nell'origine dati con i valori originali archiviati nello stato di visualizzazione. LINQ to SQL genera un'eccezione se i valori nell'origine dati sono stati modificati. È possibile eseguire una convalida aggiuntiva dei dati creando un gestore per l'evento Updating .

Costruttori

Proprietà

Metodi

Si applica a

Vedi anche

• LINQ to SQL