LinqDataSourceInsertEventArgs LinqDataSourceInsertEventArgs LinqDataSourceInsertEventArgs LinqDataSourceInsertEventArgs Class

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
LinqDataSourceInsertEventArgsLinqDataSourceInsertEventArgsLinqDataSourceInsertEventArgsLinqDataSourceInsertEventArgs

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 NewObject der-Eigenschaft wird in einen Typ Productmit dem Namen umgewandelt.The object from the NewObject property is cast to a type named Product. Die DateModified -Eigenschaft Product des-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 Label -Steuer Elements angezeigt.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 Inserting das-Ereignis übermittelt.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 Exception werden, enthält die-Eigenschaft LinqDataSourceValidationException eine Instanz der-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 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.

Konstruktoren

LinqDataSourceInsertEventArgs(LinqDataSourceValidationException) LinqDataSourceInsertEventArgs(LinqDataSourceValidationException) LinqDataSourceInsertEventArgs(LinqDataSourceValidationException) 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) LinqDataSourceInsertEventArgs(Object) LinqDataSourceInsertEventArgs(Object) LinqDataSourceInsertEventArgs(Object)

Initialisiert eine neue Instanz der LinqDataSourceInsertEventArgs-Klasse.Initializes a new instance of the LinqDataSourceInsertEventArgs 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 Einfügevorgang validiert wurden.Gets the exception that was thrown while the data was being validated before the insert 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 einzufügenden Daten enthält.Gets the object that contains the data to insert.

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: