LinqDataSourceInsertEventArgs Classe

Definição

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

public class LinqDataSourceInsertEventArgs : System.ComponentModel.CancelEventArgs

type LinqDataSourceInsertEventArgs = class
    inherit CancelEventArgs

Public Class LinqDataSourceInsertEventArgs
Inherits CancelEventArgs

Herança

Object

EventArgs

CancelEventArgs

LinqDataSourceInsertEventArgs

Exemplos

O exemplo seguinte mostra um handler para o Inserting evento. O objeto da NewObject propriedade é lançado para um tipo chamado Product. A DateModified propriedade do Product objeto é definida para a data e hora atuais.

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

O exemplo seguinte mostra um gestor de eventos para o Inserting evento. Apresenta quaisquer mensagens de exceção de validação usando um Label controlo.

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

Observações

O LinqDataSourceInsertEventArgs objeto é passado para qualquer gestor de eventos do Inserting evento. A NewObject propriedade contém os dados que serão inseridos.

Pode usar o LinqDataSourceInsertEventArgs objeto para examinar os dados antes de a operação de inserção ser executada na fonte de dados. Pode então validar os dados, examinar erros de validação da classe de dados ou alterar um valor antes da atualização. Também podes cancelar a operação de inserção.

Se o objeto que representa a fonte de dados lançar uma exceção de validação antes de inserir os dados, a Exception propriedade contém uma instância da LinqDataSourceValidationException classe. Pode recuperar todas as exceções de validação através da InnerExceptions propriedade. Se não for lançada nenhuma exceção de validação, a Exception propriedade contém null. Se tratar das exceções de validação e não quiser que a exceção seja relançada, defina a ExceptionHandled propriedade para true.