LinqDataSourceInsertEventArgs Klasa

Definicja

Udostępnia dane dla zdarzenia Inserting.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
Dziedziczenie
LinqDataSourceInsertEventArgs

Przykłady

Poniższy przykład pokazuje procedurę obsługi dla Inserting zdarzenia.The following example shows a handler for the Inserting event. Obiekt z NewObject właściwości jest rzutowany na typ o nazwie Product .The object from the NewObject property is cast to a type named Product. DateModifiedWłaściwość Product obiektu jest ustawiona na bieżącą datę i godzinę.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

Poniższy przykład pokazuje procedurę obsługi zdarzeń dla Inserting zdarzenia.The following example shows an event handler for the Inserting event. Wyświetla wszystkie komunikaty o wyjątkach weryfikacji przy użyciu Label kontrolki.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;  
    }  
}  

Uwagi

LinqDataSourceInsertEventArgsObiekt jest przesyłany do dowolnego programu obsługi zdarzeń dla Inserting zdarzenia.The LinqDataSourceInsertEventArgs object is passed to any event handler for the Inserting event. NewObjectWłaściwość zawiera dane, które zostaną wstawione.The NewObject property contains the data that will be inserted.

Można użyć LinqDataSourceInsertEventArgs obiektu do sprawdzenia danych przed wykonaniem operacji INSERT w źródle danych.You can use the LinqDataSourceInsertEventArgs object to examine the data before the insert operation is executed in the data source. Następnie można sprawdzić poprawność danych, sprawdzić błędy walidacji z klasy danych lub zmienić wartość przed aktualizacją.You can then validate the data, examine validation errors from the data class, or change a value before the update. Możesz również anulować operację wstawiania.You can also cancel the insert operation.

Jeśli obiekt reprezentujący źródło danych zgłasza wyjątek sprawdzania poprawności przed wstawieniem danych, Exception Właściwość zawiera wystąpienie LinqDataSourceValidationException klasy.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. Można pobrać wszystkie wyjątki walidacji za pomocą InnerExceptions właściwości.You can retrieve all the validation exceptions through the InnerExceptions property. Jeśli nie zostanie zgłoszony żaden wyjątek sprawdzania poprawności, Exception Właściwość zawiera null .If no validation exception is thrown, the Exception property contains null. Jeśli obsługujesz wyjątki walidacji i nie chcesz, aby wyjątek był ponownie zgłaszany, ustaw ExceptionHandled Właściwość na true .If you handle the validation exceptions and do not want the exception to be re-thrown, set the ExceptionHandled property to true.

Konstruktory

LinqDataSourceInsertEventArgs(LinqDataSourceValidationException)

Inicjuje nowe wystąpienie LinqDataSourceInsertEventArgs klasy i określa podany wyjątek.Initializes a new instance of the LinqDataSourceInsertEventArgs class and specifies the provided exception.

LinqDataSourceInsertEventArgs(Object)

Inicjuje nowe wystąpienie klasy LinqDataSourceInsertEventArgs.Initializes a new instance of the LinqDataSourceInsertEventArgs class.

Właściwości

Cancel

Pobiera lub ustawia wartość wskazującą, czy zdarzenie powinno być anulowane.Gets or sets a value indicating whether the event should be canceled.

(Odziedziczone po CancelEventArgs)
Exception

Pobiera wyjątek, który został zgłoszony podczas sprawdzania poprawności danych przed operacją wstawiania.Gets the exception that was thrown while the data was being validated before the insert operation.

ExceptionHandled

Pobiera lub ustawia wartość wskazującą, czy wyjątek został obsłużony i czy nie należy go ponownie zgłaszać.Gets or sets a value that indicates whether the exception was handled and that it should not be thrown again.

NewObject

Pobiera obiekt, który zawiera dane do wstawienia.Gets the object that contains the data to insert.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy