LinqDataSourceInsertEventArgs Classe

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Fornisce i dati per l'evento Inserting.

public ref class LinqDataSourceInsertEventArgs : System::ComponentModel::CancelEventArgs

public class LinqDataSourceInsertEventArgs : System.ComponentModel.CancelEventArgs

type LinqDataSourceInsertEventArgs = class
    inherit CancelEventArgs

Public Class LinqDataSourceInsertEventArgs
Inherits CancelEventArgs

Ereditarietà

Object

EventArgs

CancelEventArgs

LinqDataSourceInsertEventArgs

Esempio

Nell'esempio seguente viene illustrato un gestore per l'evento Inserting . L'oggetto della proprietà viene eseguito il NewObject cast a un tipo denominato Product. La DateModified proprietà dell'oggetto è impostata sulla data e l'ora Product correnti.

protected void LinqDataSource_Inserting(object sender, LinqDataSourceInsertEventArgs e)
{
    Product product = (Product)e.NewObject;
    product.DateModified = DateTime.Now;
}

Protected Sub LinqDataSource_Inserting(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceInsertEventArgs)
    Dim product As Product
    product = CType(e.NewObject, Product)
    product.DateModified = DateTime.Now
End Sub

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

Protected Sub LinqDataSource_Inserting(ByVal sender As Object, _  
        ByVal e As LinqDataSourceInsertEventArgs)  
    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_Inserting(object sender,   
        LinqDataSourceInsertEventArgs 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 LinqDataSourceInsertEventArgs viene passato a qualsiasi gestore eventi per l'evento Inserting . La NewObject proprietà contiene i dati che verranno inseriti.

È possibile utilizzare l'oggetto LinqDataSourceInsertEventArgs per esaminare i dati prima dell'esecuzione dell'operazione di inserimento nell'origine dati. È quindi possibile convalidare i dati, esaminare gli errori di convalida dalla classe dati o modificare un valore prima dell'aggiornamento. È anche possibile annullare l'operazione di inserimento.

Se l'oggetto che rappresenta l'origine dati genera un'eccezione di convalida prima di inserire 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.

Costruttori

LinqDataSourceInsertEventArgs(LinqDataSourceValidationException)	Inizializza una nuova istanza della classe LinqDataSourceInsertEventArgs e specifica l'eccezione fornita.
LinqDataSourceInsertEventArgs(Object)	Inizializza una nuova istanza della classe LinqDataSourceInsertEventArgs.

Proprietà

Cancel	Ottiene o imposta un valore che indica se l'evento debba essere annullato. (Ereditato da CancelEventArgs)
Exception	Ottiene l'eccezione generata durante la convalida dei dati prima dell'operazione di inserimento.
ExceptionHandled	Ottiene o imposta un valore che indica se l'eccezione è stata gestita e non deve essere nuovamente generata.
NewObject	Ottiene l'oggetto contenente i dati da inserire.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)