LinqDataSourceUpdateEventArgs Classe

Definição

public ref class LinqDataSourceUpdateEventArgs : System::ComponentModel::CancelEventArgs

public class LinqDataSourceUpdateEventArgs : System.ComponentModel.CancelEventArgs

type LinqDataSourceUpdateEventArgs = class
    inherit CancelEventArgs

Public Class LinqDataSourceUpdateEventArgs
Inherits CancelEventArgs

Herança

Object

EventArgs

CancelEventArgs

LinqDataSourceUpdateEventArgs

Exemplos

O exemplo seguinte mostra um gestor de eventos para o Updating evento. O exemplo mostra como comparar propriedades da OriginalObject propriedade e da NewObject propriedade para determinar se o valor da Category propriedade mudou. Se assim for, a CategoryChanged propriedade do objeto na NewObject propriedade é definida como true.

protected void LinqDataSource_Updating(object sender, LinqDataSourceUpdateEventArgs e)
{
    Product originalProduct = (Product)e.OriginalObject;
    Product newProduct = (Product)e.NewObject;

    if (originalProduct.Category != newProduct.Category)
    {
        newProduct.CategoryChanged = true;
    }
}

Protected Sub LinqDataSource_Updating(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceUpdateEventArgs)
    Dim originalProduct As Product
    Dim newProduct As Product

    originalProduct = CType(e.OriginalObject, Product)
    newProduct = CType(e.NewObject, Product)

    If (originalProduct.Category <> newProduct.Category) Then
        newProduct.CategoryChanged = True
    End If
End Sub

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

Protected Sub LinqDataSource_Updating(ByVal sender As Object, _
        ByVal e As LinqDataSourceUpdateEventArgs)
    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_Updating(object sender,
        LinqDataSourceUpdateEventArgs 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 LinqDataSourceUpdateEventArgs objeto é passado para qualquer gestor de eventos do Updating evento. Pode usar o LinqDataSourceUpdateEventArgs objeto para examinar os dados antes de a operação de atualização ser executada na fonte de dados. Pode então validar os dados, examinar exceções de validação lançadas pela classe de dados ou alterar um valor antes da atualização. Também podes cancelar a operação de atualização.

O OriginalObject objeto contém os dados que foram originalmente recuperados da fonte de dados. O NewObject objeto contém os dados que serão guardados na fonte de dados durante a operação de atualização.

Se o objeto que representa a fonte de dados lançar uma exceção de validação antes de atualizar 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.

Por defeito, o controlo LinqDataSource armazena os valores originais da fonte de dados no estado de visualização na página Web, exceto aqueles cujo ColumnAttribute atributo está marcado como UpdateCheck.Never. O LINQ para SQL verifica automaticamente a integridade dos dados antes de os atualizar. Faz isto comparando os valores atuais na fonte de dados com os valores originais armazenados no estado de visualização. LINQ para SQL levanta uma exceção se os valores na fonte de dados tiverem sido alterados. Pode realizar validação adicional de dados criando um handler para o Updating evento.

Ver também

• LINQ para SQL