LinqDataSourceInsertEventArgs Klasse

Definition

Stellt Daten für das Inserting-Ereignis bereit.Provides data for the Inserting event.

public ref class LinqDataSourceInsertEventArgs : System::ComponentModel::CancelEventArgs
public class LinqDataSourceInsertEventArgs : System.ComponentModel.CancelEventArgs
type LinqDataSourceInsertEventArgs = class
    inherit CancelEventArgs
Public Class LinqDataSourceInsertEventArgs
Inherits CancelEventArgs
Vererbung
LinqDataSourceInsertEventArgs

Beispiele

Das folgende Beispiel zeigt einen Handler für das- Inserting Ereignis.The following example shows a handler for the Inserting event. Das-Objekt aus der- NewObject Eigenschaft wird in einen Typ mit dem Namen umgewandelt Product .The object from the NewObject property is cast to a type named Product. Die- DateModified Eigenschaft des- Product Objekts wird auf das aktuelle Datum und die aktuelle Uhrzeit festgelegt.The DateModified property of the Product object is set to the current date and time.

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

Das folgende Beispiel zeigt einen Ereignishandler für das- Inserting Ereignis.The following example shows an event handler for the Inserting event. Alle Validierungs Ausnahme Meldungen werden mithilfe eines-Steuer Elements angezeigt Label .It displays any validation exception messages by using a Label control.

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

Hinweise

Das- LinqDataSourceInsertEventArgs Objekt wird an einen beliebigen Ereignishandler für das-Ereignis übermittelt Inserting .The LinqDataSourceInsertEventArgs object is passed to any event handler for the Inserting event. Die- NewObject Eigenschaft enthält die Daten, die eingefügt werden.The NewObject property contains the data that will be inserted.

Sie können das- LinqDataSourceInsertEventArgs Objekt verwenden, um die Daten zu untersuchen, bevor der Einfügevorgang in der Datenquelle ausgeführt wird.You can use the LinqDataSourceInsertEventArgs object to examine the data before the insert operation is executed in the data source. Anschließend können Sie die Daten überprüfen, Validierungs Fehler von der Datenklasse überprüfen oder einen Wert vor dem Update ändern.You can then validate the data, examine validation errors from the data class, or change a value before the update. Sie können auch den Einfügevorgang abbrechen.You can also cancel the insert operation.

Wenn das Objekt, das die Datenquelle darstellt, eine Validierungs Ausnahme auslöst, bevor die Daten eingefügt werden, enthält die- Exception Eigenschaft eine Instanz der- LinqDataSourceValidationException Klasse.If the object that represents the data source throws a validation exception before it inserts the data, the Exception property contains an instance of the LinqDataSourceValidationException class. Mithilfe der-Eigenschaft können Sie alle Validierungs Ausnahmen abrufen InnerExceptions .You can retrieve all the validation exceptions through the InnerExceptions property. Wenn keine Validierungs Ausnahme ausgelöst wird, enthält die- Exception Eigenschaft null .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 fest true .If you handle the validation exceptions and do not want the exception to be re-thrown, set the ExceptionHandled property to true.

Konstruktoren

LinqDataSourceInsertEventArgs(LinqDataSourceValidationException)

Initialisiert eine neue Instanz der LinqDataSourceInsertEventArgs-Klasse und gibt die bereitgestellte Ausnahme an.Initializes a new instance of the LinqDataSourceInsertEventArgs class and specifies the provided exception.

LinqDataSourceInsertEventArgs(Object)

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

Eigenschaften

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.

(Geerbt von CancelEventArgs)
Exception

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

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

Ruft das Objekt ab, das die einzufügenden Daten enthält.Gets the object that contains the data to insert.

Methoden

Equals(Object)

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

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetType()

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

(Geerbt von Object)
MemberwiseClone()

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

(Geerbt von Object)
ToString()

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

(Geerbt von Object)

Gilt für: