LinqDataSource.Updating Zdarzenie

Definicja

Występuje przed operacją Update.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) 

Typ zdarzenia

EventHandler<LinqDataSourceUpdateEventArgs>

Przykłady

Poniższy przykład pokazuje procedurę obsługi zdarzeń dla Updating zdarzenia.The following example shows an event handler for the Updating event. Kod porównuje właściwości z OriginalObject właściwością i NewObject właściwością, aby zobaczyć, czy wartość została zmieniona.The code compares properties from the OriginalObject property and the NewObject property to see whether a value has changed. Jeśli wartość została zmieniona, wartość NewObject właściwości jest ustawiona na true .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

Poniższy przykład pokazuje program obsługi zdarzeń dla Updating zdarzenia, które pobiera wyjątki walidacji.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;  
    }  
}  

Poprzedni przykład pobiera wyjątki walidacji.The previous example retrieves validation exceptions. Wyjątek może zostać wygenerowany, jeśli wartość nie jest zgodna z typem właściwości.An exception might be thrown if a value does not match the type of the property. Może być również zgłaszane z dostosowanego sprawdzenia, takiego jak ten w poniższym przykładzie.It might also be thrown from a customized check such as the one in the following example. OnAgeChangingMetoda sprawdza, czy liczba Age właściwości nie jest ujemna.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  

Uwagi

Obsłuż Updating zdarzenie, aby sprawdzić poprawność obiektu do zaktualizowania, aby sprawdzić błędy walidacji danych z klasy danych, zmienić wartość przed operacją aktualizacji lub aby anulować operację aktualizacji.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. LinqDataSourceUpdateEventArgsObiekt, który jest przesyłany do programów obsługi zdarzeń, zawiera zarówno oryginalny obiekt, jak i zaktualizowany obiekt.The LinqDataSourceUpdateEventArgs object that is passed to event handlers contains both the original object and the updated object.

Jeśli podczas operacji aktualizacji wystąpi błąd walidacji, LinqDataSourceInsertEventArgs obiekt zawiera wyjątki walidacji, które są zgłaszane przez klasę danych.If a validation error occurs during the update operation, the LinqDataSourceInsertEventArgs object contains the validation exceptions that are thrown by the data class. Błąd walidacji występuje, jeśli wartość, która ma zostać zaktualizowana, jest niezgodna z typem właściwości w klasie danych lub jeśli nie przeszedł niestandardowego sprawdzania poprawności.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. W procedurze obsługi zdarzeń dla Updating zdarzenia można pobrać wyjątki walidacji i podjąć odpowiednie działania.In an event handler for the Updating event, you can retrieve the validation exceptions and take appropriate action.

Jeśli wyjątek jest zgłaszany w procedurze obsługi zdarzeń dla Updating zdarzenia, należy obsłużyć wyjątek w tym obsłudze zdarzeń.If an exception is thrown in an event handler for the Updating event, you must handle the exception in that event handler. Wyjątek nie zostanie przesłany do procedury obsługi zdarzeń dla Updated zdarzenia (przez Exception Właściwość LinqDataSourceStatusEventArgs obiektu).The exception will not be passed to an event handler for the Updated event (through the Exception property of the LinqDataSourceStatusEventArgs object). ExceptionWłaściwość zawiera tylko wyjątki, które są zgłaszane po Updating zdarzeniu.The Exception property contains only the exceptions that are thrown after the Updating event.

Dotyczy