LinqDataSource.Updating LinqDataSource.Updating LinqDataSource.Updating LinqDataSource.Updating Event

Definition

Tritt vor einem Aktualisierungsvorgang ein.Occurs before an update operation.

public:
 event EventHandler<System::Web::UI::WebControls::LinqDataSourceUpdateEventArgs ^> ^ Updating;
public event EventHandler<System.Web.UI.WebControls.LinqDataSourceUpdateEventArgs> Updating;
member this.Updating : EventHandler<System.Web.UI.WebControls.LinqDataSourceUpdateEventArgs> 
Public Custom Event Updating As EventHandler(Of LinqDataSourceUpdateEventArgs) 

Beispiele

Das folgende Beispiel zeigt einen Ereignishandler für das Updating -Ereignis.The following example shows an event handler for the Updating event. Der Code vergleicht Eigenschaften aus der OriginalObject -Eigenschaft und NewObject der-Eigenschaft, um festzustellen, ob sich ein Wert geändert hat.The code compares properties from the OriginalObject property and the NewObject property to see whether a value has changed. Wenn der Wert geändert wurde, wird ein Wert NewObject der-Eigenschaft auf truefestgelegt.If the value has changed, a value of 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

Das folgende Beispiel zeigt einen Ereignishandler für das Updating -Ereignis, das Validierungs Ausnahmen abruft.The following example shows an event handler for the Updating event that retrieves validation exceptions.

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

Im vorherigen Beispiel werden Validierungs Ausnahmen abgerufen.The previous example retrieves validation exceptions. Eine Ausnahme kann ausgelöst werden, wenn ein Wert nicht mit dem Typ der Eigenschaft identisch ist.An exception might be thrown if a value does not match the type of the property. Sie kann auch von einer angepassten Prüfung wie der im folgenden Beispiel ausgelöst werden.It might also be thrown from a customized check such as the one in the following example. Die OnAgeChanging -Methode überprüft, ob die Zahl Age für die-Eigenschaft nicht negativ ist.The OnAgeChanging method checks that the number for the Age property is not negative.

partial void  OnAgeChanging(int? value)  
{  
    if (value < 0)  
    {  
        throw new Exception("Age cannot be a negative number.");  
    }  
}  
Private Sub OnAgeChanging(ByVal value As System.Nullable(Of Integer))  
    If (value < 0) Then  
        Throw New Exception("Age cannot be a negative number.")  
    End If  
End Sub  

Hinweise

Behandeln Sie Updating das-Ereignis, um das zu Aktualisier Ende Objekt zu überprüfen, Daten Validierungs Fehler der Datenklasse zu untersuchen, einen Wert vor dem Aktualisierungs Vorgang zu ändern oder den Aktualisierungs Vorgang abzubrechen.Handle the Updating event to validate the object to be updated, to examine data validation errors from the data class, to change a value before the update operation, or to cancel the update operation. Das LinqDataSourceUpdateEventArgs -Objekt, das an Ereignishandler übermittelt wird, enthält sowohl das ursprüngliche-Objekt als auch das aktualisierte-Objekt.The LinqDataSourceUpdateEventArgs object that is passed to event handlers contains both the original object and the updated object.

Wenn während des Aktualisierungs Vorgangs ein Validierungs Fehler auftritt, LinqDataSourceInsertEventArgs enthält das-Objekt die Validierungs Ausnahmen, die von der Datenklasse ausgelöst werden.If a validation error occurs during the update operation, the LinqDataSourceInsertEventArgs object contains the validation exceptions that are thrown by the data class. Ein Validierungs Fehler tritt auf, wenn ein zu aktualisierenden Wert nicht mit dem Typ der Eigenschaft in der Datenklasse identisch ist, oder wenn er keine benutzerdefinierte Validierungs Überprüfung übergibt.A validation error occurs if a value to be updated does not match the type of the property in the data class, or if it does not pass a custom validation check. In einem Ereignishandler für das Updating -Ereignis können Sie die Validierungs Ausnahmen abrufen und entsprechende Maßnahmen ergreifen.In an event handler for the Updating event, you can retrieve the validation exceptions and take appropriate action.

Wenn eine Ausnahme in einem Ereignishandler für das Updating -Ereignis ausgelöst wird, muss die Ausnahme in diesem Ereignishandler behandelt werden.If an exception is thrown in an event handler for the Updating event, you must handle the exception in that event handler. Die-Ausnahme wird nicht an einen Ereignishandler für das Updated -Ereignis (über die Exception -Eigenschaft des LinqDataSourceStatusEventArgs -Objekts) übermittelt.The exception will not be passed to an event handler for the Updated event (through the Exception property of the LinqDataSourceStatusEventArgs object). Die Exception -Eigenschaft enthält nur die Ausnahmen, die nach dem Updating -Ereignis ausgelöst werden.The Exception property contains only the exceptions that are thrown after the Updating event.

Gilt für: