LinqDataSourceUpdateEventArgs LinqDataSourceUpdateEventArgs LinqDataSourceUpdateEventArgs LinqDataSourceUpdateEventArgs Class

Definition

Stellt Daten für das Updating-Ereignis bereit.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
Vererbung
LinqDataSourceUpdateEventArgsLinqDataSourceUpdateEventArgsLinqDataSourceUpdateEventArgsLinqDataSourceUpdateEventArgs

Beispiele

Das folgende Beispiel zeigt einen Ereignishandler für das Updating -Ereignis.The following example shows an event handler for the Updating event. Das Beispiel zeigt, wie Eigenschaften aus der OriginalObject -Eigenschaft und der NewObject -Eigenschaft verglichen werden, um zu bestimmen, ob sich der Wert in der Category -Eigenschaft geändert hat.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. Wenn dies der Fall CategoryChanged ist, wird die-Eigenschaft NewObject des-Objekts in trueder-Eigenschaft auf festgelegt.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

Das folgende Beispiel zeigt einen Ereignishandler für das Updating -Ereignis.The following example shows an event handler for the Updating event. Alle Validierungs Ausnahme Meldungen werden mithilfe eines Label -Steuer Elements angezeigt.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;  
    }  
}  

Hinweise

Das LinqDataSourceUpdateEventArgs -Objekt wird an einen beliebigen Ereignishandler für Updating das-Ereignis übermittelt.The LinqDataSourceUpdateEventArgs object is passed to any event handler for the Updating event. Sie können das LinqDataSourceUpdateEventArgs -Objekt verwenden, um die Daten zu untersuchen, bevor der Aktualisierungs Vorgang in der Datenquelle ausgeführt wird.You can use the LinqDataSourceUpdateEventArgs object to examine the data before the update operation is executed in the data source. Anschließend können Sie die Daten überprüfen, Validierungs Ausnahmen untersuchen, die von der Datenklasse ausgelöst werden, oder einen Wert vor dem Update ändern.You can then validate the data, examine validation exceptions thrown by the data class, or change a value before the update. Sie können auch den Aktualisierungs Vorgang abbrechen.You can also cancel the update operation.

Das OriginalObject -Objekt enthält die Daten, die ursprünglich aus der Datenquelle abgerufen wurden.The OriginalObject object contains the data that was originally retrieved from the data source. Das NewObject -Objekt enthält die Daten, die während des Aktualisierungs Vorgangs in der Datenquelle gespeichert werden.The NewObject object contains the data that will be saved in the data source during the update operation.

Wenn das Objekt, das die Datenquelle darstellt, vor dem Aktualisieren der Daten eine Validierungs Ausnahme Exception auslöst, enthält die-Eigenschaft LinqDataSourceValidationException eine Instanz der-Klasse.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. Mithilfe der InnerExceptions -Eigenschaft können Sie alle Validierungs Ausnahmen abrufen.You can retrieve all the validation exceptions through the InnerExceptions property. Wenn keine Validierungs Ausnahme ausgelöst wird, enthält Exception nulldie-Eigenschaft.If no validation exception is thrown, the Exception property contains null. Wenn Sie die Validierungs Ausnahmen behandeln und die Ausnahme nicht erneut ausgelöst werden soll, legen Sie die ExceptionHandled -Eigenschaft auf truefest.If you handle the validation exceptions and do not want the exception to be re-thrown, set the ExceptionHandled property to true.

Standardmäßig speichert das LinqDataSource -Steuerelement die ursprünglichen Werte aus der Datenquelle im Ansichts Zustand auf der Webseite, mit Ausnahme ColumnAttribute derjenigen, deren- UpdateCheck.NeverAttribut als gekennzeichnet ist.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 überprüft automatisch die Integrität der Daten, bevor die Daten aktualisiert werden.LINQ to SQL automatically checks the integrity of the data before updating the data. Dies geschieht durch Vergleichen der aktuellen Werte in der Datenquelle mit den im Ansichts Zustand gespeicherten ursprünglichen Werten.It does this by comparing the current values in the data source with the original values stored in view state. LINQ to SQL löst eine Ausnahme aus, wenn sich die Werte in der Datenquelle geändert haben.LINQ to SQL raises an exception if the values in the data source have changed. Sie können zusätzliche Daten Validierungen durchführen, indem Sie einen Updating Handler für das-Ereignis erstellen.You can perform additional data validation by creating a handler for the Updating event.

Konstruktoren

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

Initialisiert eine neue Instanz der LinqDataSourceUpdateEventArgs-Klasse mit der angegebenen Ausnahme.Initializes a new instance of the LinqDataSourceUpdateEventArgs class with the specified exception.

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

Initialisiert eine neue Instanz der LinqDataSourceUpdateEventArgs-Klasse.Initializes a new instance of the LinqDataSourceUpdateEventArgs class.

Eigenschaften

Cancel Cancel Cancel Cancel

Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest.Gets or sets a value indicating whether the event should be canceled.

(Inherited from CancelEventArgs)
Exception Exception Exception Exception

Ruft die Ausnahme ab, die ausgelöst wurde, während die Daten vor dem Aktualisierungsvorgang validiert wurden.Gets the exception that was thrown while the data was being validated before the update operation.

ExceptionHandled ExceptionHandled ExceptionHandled ExceptionHandled

Ruft einen Wert ab, der angibt, ob die Ausnahme behandelt wurde und dass diese nicht erneut ausgelöst werden soll, oder legt diesen fest.Gets or sets a value that indicates whether the exception was handled and that it should not be thrown again.

NewObject NewObject NewObject NewObject

Ruft das Objekt ab, das die Werte enthält, die in der Datenquelle gespeichert werden.Gets the object that contains the values that will be saved in the data source.

OriginalObject OriginalObject OriginalObject OriginalObject

Ruft das Objekt mit den Werten ab, die ursprünglich von der Datenquelle abgerufen wurden.Gets the object that contains the values that were originally retrieved from the data source.

Methoden

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch