LinqDataSourceInsertEventArgs Clase

Definición

Proporciona datos para el evento 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
Herencia
LinqDataSourceInsertEventArgs

Ejemplos

En el ejemplo siguiente se muestra un controlador Inserting para el evento.The following example shows a handler for the Inserting event. El objeto desde el NewObject propiedad se convierte en un tipo denominado Product.The object from the NewObject property is cast to a type named Product. El DateModified propiedad de la Product objeto se establece en la fecha y hora actuales.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

En el ejemplo siguiente se muestra un controlador de Inserting eventos para el evento.The following example shows an event handler for the Inserting event. Muestra los mensajes de excepción de validación mediante un Label control.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;  
    }  
}  

Comentarios

El LinqDataSourceInsertEventArgs objeto se pasa a cualquier controlador de eventos para Inserting el evento.The LinqDataSourceInsertEventArgs object is passed to any event handler for the Inserting event. La NewObject propiedad contiene los datos que se van a insertar.The NewObject property contains the data that will be inserted.

Puede utilizar el LinqDataSourceInsertEventArgs objeto para examinar los datos antes de que se ejecute la operación de inserción en el origen de datos.You can use the LinqDataSourceInsertEventArgs object to examine the data before the insert operation is executed in the data source. Después, puede validar los datos, examinar los errores de validación de la clase de datos o cambiar un valor antes de la actualización.You can then validate the data, examine validation errors from the data class, or change a value before the update. También puede cancelar la operación de inserción.You can also cancel the insert operation.

Si el objeto que representa el origen de datos produce una excepción de validación antes de insertar los datos, la Exception propiedad contiene una instancia de la LinqDataSourceValidationException clase.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. Puede recuperar todas las excepciones de validación a través InnerExceptions de la propiedad.You can retrieve all the validation exceptions through the InnerExceptions property. Si no se produce ninguna excepción de validación Exception , la nullpropiedad contiene.If no validation exception is thrown, the Exception property contains null. Si controla las excepciones de validación y no desea que se vuelvan a producir la excepción, establezca la ExceptionHandled propiedad en true.If you handle the validation exceptions and do not want the exception to be re-thrown, set the ExceptionHandled property to true.

Constructores

LinqDataSourceInsertEventArgs(LinqDataSourceValidationException)

Inicializa una nueva instancia de la clase LinqDataSourceInsertEventArgs y especifica la excepción proporcionada.Initializes a new instance of the LinqDataSourceInsertEventArgs class and specifies the provided exception.

LinqDataSourceInsertEventArgs(Object)

Inicializa una nueva instancia de la clase LinqDataSourceInsertEventArgs.Initializes a new instance of the LinqDataSourceInsertEventArgs class.

Propiedades

Cancel

Obtiene o establece un valor que indica si se debe cancelar el evento.Gets or sets a value indicating whether the event should be canceled.

(Heredado de CancelEventArgs)
Exception

Obtiene la excepción que se produjo mientras se validaban los datos antes de la operación de inserción.Gets the exception that was thrown while the data was being validated before the insert operation.

ExceptionHandled

Obtiene o establece un valor que indica si se controló la excepción y que no se debería iniciar de nuevo.Gets or sets a value that indicates whether the exception was handled and that it should not be thrown again.

NewObject

Obtiene el objeto que contiene los datos que se van a insertar.Gets the object that contains the data to insert.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Se aplica a