LinqDataSourceInsertEventArgs Classe

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Fornece dados para o evento de Inserting .

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 a seguir mostra um manipulador para o Inserting evento. O objeto da NewObject propriedade é convertido em um tipo chamado Product. A DateModified propriedade do Product objeto é definida como a data e a 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 a seguir mostra um manipulador de eventos para o Inserting evento. Ele exibe qualquer mensagem de exceção de validação usando um Label controle .

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

Comentários

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

Você pode usar o LinqDataSourceInsertEventArgs objeto para examinar os dados antes que a operação de inserção seja executada na fonte de dados. Em seguida, você pode validar os dados, examinar erros de validação da classe de dados ou alterar um valor antes da atualização. Você também pode cancelar a operação de inserção.

Se o objeto que representa a fonte de dados gerar uma exceção de validação antes de inserir os dados, a Exception propriedade conterá uma instância da LinqDataSourceValidationException classe . Você pode recuperar todas as exceções de validação por meio da InnerExceptions propriedade . Se nenhuma exceção de validação for gerada, a Exception propriedade conterá null. Se você manipular as exceções de validação e não quiser que a exceção seja lançada novamente, defina a ExceptionHandled propriedade como true.

Construtores

LinqDataSourceInsertEventArgs(LinqDataSourceValidationException)	Inicializa uma nova instância da classe LinqDataSourceInsertEventArgs e especifica a exceção fornecida.
LinqDataSourceInsertEventArgs(Object)	Inicializa uma nova instância da classe LinqDataSourceInsertEventArgs.

Propriedades

Cancel	Obtém ou define um valor que indica se o evento deve ser cancelado. (Herdado de CancelEventArgs)
Exception	Obtém a exceção gerada enquanto os dados estavam sendo validados antes da operação de inserção.
ExceptionHandled	Obtém ou define um valor que indica se a exceção foi tratada e que ela não deve ser gerada novamente.
NewObject	Obtém um objeto que contém os dados a serem inseridos.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)