LinqDataSourceUpdateEventArgs LinqDataSourceUpdateEventArgs LinqDataSourceUpdateEventArgs LinqDataSourceUpdateEventArgs Class

Definizione

Fornisce dati per l'evento Updating.Provides data for the Updating event.

public ref class LinqDataSourceUpdateEventArgs : System::ComponentModel::CancelEventArgs
public class LinqDataSourceUpdateEventArgs : System.ComponentModel.CancelEventArgs
type LinqDataSourceUpdateEventArgs = class
    inherit CancelEventArgs
Public Class LinqDataSourceUpdateEventArgs
Inherits CancelEventArgs
Ereditarietà
LinqDataSourceUpdateEventArgsLinqDataSourceUpdateEventArgsLinqDataSourceUpdateEventArgsLinqDataSourceUpdateEventArgs

Esempi

Nell'esempio seguente viene illustrato un gestore eventi per Updating l'evento.The following example shows an event handler for the Updating event. Nell'esempio viene illustrato come confrontare le proprietà OriginalObject della proprietà e la NewObject proprietà per determinare Category se il valore della proprietà è stato modificato.The example shows how to compare properties from the OriginalObject property and the NewObject property to determine whether the value in the Category property has changed. In tal caso, CategoryChanged la proprietà dell'oggetto nella true proprietàNewObject viene impostata su.If so, the CategoryChanged property of the object in the NewObject property is set to 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 Updating l'evento.The following example shows an event handler for the Updating event. Vengono visualizzati tutti i messaggi di eccezione di convalida Label usando un controllo.It displays any validation exception messages by using a Label control.

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' LinqDataSourceUpdateEventArgs oggetto viene passato a qualsiasi gestore eventi per l' Updating evento.The LinqDataSourceUpdateEventArgs object is passed to any event handler for the Updating event. È possibile utilizzare l' LinqDataSourceUpdateEventArgs oggetto per esaminare i dati prima dell'esecuzione dell'operazione di aggiornamento nell'origine dati.You can use the LinqDataSourceUpdateEventArgs object to examine the data before the update operation is executed in the data source. È quindi possibile convalidare i dati, esaminare le eccezioni di convalida generate dalla classe di dati o modificare un valore prima dell'aggiornamento.You can then validate the data, examine validation exceptions thrown by the data class, or change a value before the update. È anche possibile annullare l'operazione di aggiornamento.You can also cancel the update operation.

L' OriginalObject oggetto contiene i dati recuperati originariamente dall'origine dati.The OriginalObject object contains the data that was originally retrieved from the data source. L' NewObject oggetto contiene i dati che verranno salvati nell'origine dati durante l'operazione di aggiornamento.The NewObject object contains the data that will be saved in the data source during the update operation.

Se l'oggetto che rappresenta l'origine dati genera un'eccezione Exception LinqDataSourceValidationException di convalida prima di aggiornare i dati, la proprietà contiene un'istanza della classe.If the object that represents the data source throws a validation exception before updating the data, the Exception property contains an instance of the LinqDataSourceValidationException class. È possibile recuperare tutte le eccezioni di convalida tramite InnerExceptions la proprietà.You can retrieve all the validation exceptions through the InnerExceptions property. Se non viene generata alcuna eccezione di convalida Exception , la nullproprietà contiene.If no validation exception is thrown, the Exception property contains null. Se si gestiscono le eccezioni di convalida e non si desidera che venga generata nuovamente l'eccezione, impostare ExceptionHandled la proprietà truesu.If you handle the validation exceptions and do not want the exception to be re-thrown, set the ExceptionHandled property to true.

Per impostazione predefinita, LinqDataSource il controllo archivia i valori originali dall'origine dati in stato di visualizzazione nella pagina Web, ad eccezione di ColumnAttribute quelli il cui attributo UpdateCheck.Neverè contrassegnato come.By default, the LinqDataSource control stores the original values from the data source in view state on the Web page, except those whose ColumnAttribute attribute is marked as UpdateCheck.Never. LINQ to SQL controlla automaticamente l'integrità dei dati prima di aggiornare i dati.LINQ to SQL automatically checks the integrity of the data before updating the data. Questa operazione viene eseguita confrontando i valori correnti nell'origine dati con i valori originali archiviati nello stato di visualizzazione.It does this by comparing the current values in the data source with the original values stored in view state. LINQ to SQL genera un'eccezione se i valori nell'origine dati sono stati modificati.LINQ to SQL raises an exception if the values in the data source have changed. È possibile eseguire la convalida dei dati aggiuntiva creando un gestore Updating per l'evento.You can perform additional data validation by creating a handler for the Updating event.

Costruttori

LinqDataSourceUpdateEventArgs(LinqDataSourceValidationException) LinqDataSourceUpdateEventArgs(LinqDataSourceValidationException) LinqDataSourceUpdateEventArgs(LinqDataSourceValidationException) LinqDataSourceUpdateEventArgs(LinqDataSourceValidationException)

Consente l'inizializzazione di una nuova istanza della classe LinqDataSourceUpdateEventArgs con l'eccezione specificata.Initializes a new instance of the LinqDataSourceUpdateEventArgs class with the specified exception.

LinqDataSourceUpdateEventArgs(Object, Object) LinqDataSourceUpdateEventArgs(Object, Object) LinqDataSourceUpdateEventArgs(Object, Object) LinqDataSourceUpdateEventArgs(Object, Object)

Inizializza una nuova istanza della classe LinqDataSourceUpdateEventArgs.Initializes a new instance of the LinqDataSourceUpdateEventArgs class.

Proprietà

Cancel Cancel Cancel Cancel

Ottiene o imposta un valore che indica se l'evento debba essere annullato.Gets or sets a value indicating whether the event should be canceled.

(Inherited from CancelEventArgs)
Exception Exception Exception Exception

Ottiene l'eccezione generata durante la convalida dei dati prima dell'operazione di aggiornamento.Gets the exception that was thrown while the data was being validated before the update operation.

ExceptionHandled ExceptionHandled ExceptionHandled ExceptionHandled

Ottiene o imposta un valore che indica se l'eccezione è stata gestita e non deve essere nuovamente generata.Gets or sets a value that indicates whether the exception was handled and that it should not be thrown again.

NewObject NewObject NewObject NewObject

Ottiene l'oggetto che contiene i valori che verranno salvati nell'origine dati.Gets the object that contains the values that will be saved in the data source.

OriginalObject OriginalObject OriginalObject OriginalObject

Ottiene l'oggetto che contiene i valori originariamente recuperati dall'origine dati.Gets the object that contains the values that were originally retrieved from the data source.

Metodi

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Si applica a

Vedi anche