LinqDataSourceInsertEventArgs Klasse

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Stellt Daten für das Inserting-Ereignis bereit.

public ref class LinqDataSourceInsertEventArgs : System::ComponentModel::CancelEventArgs

public class LinqDataSourceInsertEventArgs : System.ComponentModel.CancelEventArgs

type LinqDataSourceInsertEventArgs = class
    inherit CancelEventArgs

Public Class LinqDataSourceInsertEventArgs
Inherits CancelEventArgs

Vererbung

Object

EventArgs

CancelEventArgs

LinqDataSourceInsertEventArgs

Beispiele

Das folgende Beispiel zeigt einen Handler für das Inserting Ereignis. Das -Objekt aus der NewObject -Eigenschaft wird in einen Typ namens Productumgewandelt. Die DateModified -Eigenschaft des Product -Objekts ist auf das aktuelle Datum und die aktuelle Uhrzeit festgelegt.

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. Es werden alle Validierungs-Ausnahmemeldungen mithilfe eines -Steuerelements Label angezeigt.

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 Inserting Ereignis übergeben. Die NewObject -Eigenschaft enthält die Daten, die eingefügt werden.

Sie können das LinqDataSourceInsertEventArgs -Objekt verwenden, um die Daten zu untersuchen, bevor der Einfügevorgang in der Datenquelle ausgeführt wird. Anschließend können Sie die Daten überprüfen, Validierungsfehler aus der Datenklasse untersuchen oder einen Wert vor der Aktualisierung ändern. Sie können den Einfügevorgang auch abbrechen.

Wenn das Objekt, das die Datenquelle darstellt, eine Validierungs-Ausnahme auslöst, bevor es die Daten einfügt, enthält die Exception -Eigenschaft eine instance der LinqDataSourceValidationException -Klasse. Sie können alle Validierungsausnahmen über die InnerExceptions -Eigenschaft abrufen. Wenn keine Validierungs-Ausnahme ausgelöst wird, enthält nulldie Exception -Eigenschaft . Wenn Sie die Validierungsausnahmen behandeln und die Ausnahme nicht erneut ausgelöst werden soll, legen Sie die ExceptionHandled -Eigenschaft auf fest true.

Konstruktoren

LinqDataSourceInsertEventArgs(LinqDataSourceValidationException)	Initialisiert eine neue Instanz der LinqDataSourceInsertEventArgs-Klasse und gibt die bereitgestellte Ausnahme an.
LinqDataSourceInsertEventArgs(Object)	Initialisiert eine neue Instanz der LinqDataSourceInsertEventArgs-Klasse.

Eigenschaften

Cancel	Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest. (Geerbt von CancelEventArgs)
Exception	Ruft die Ausnahme ab, die ausgelöst wurde, während die Daten vor dem Einfügevorgang validiert wurden.
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.
NewObject	Ruft das Objekt ab, das die einzufügenden Daten enthält.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)