Como: manipular eventos de dados

Você pode personalizar seu aplicativo escrevendo código que executa quando determinados eventos de dados ocorrem.Por exemplo, você pode escrever código que será executado quando as linhas de dados em uma tabela são criadas, acessadas, alteradas, ou excluídas.Você também pode escrever código para verificar que um usuário tem permissão para modificar a fonte de dados.

Os eventos que você pode manipular podem ser agrupadas em seis categorias:

• Métodos gerais que são executados quando os dados são criados, excluídos, ou modificado.

• Métodos de acesso ao controle que são executados quando os dados são criados, excluídos, ou modificado.

• Métodos de consulta que são executados quando uma fonte de dados é consultada.

• Métodos de fonte de dados que são executados quando uma fonte de dados é salva.

• Métodos de propriedades que são executados quando uma propriedade é alterada.

Uma descrição desses métodos aparece nas tabelas no final deste tópico.

Para manipular um evento relacionado a dados

1. No Gerenciador de Soluções, clique duas vezes em uma entidade ou uma tabela.

   A entidade ou a tabela abre no Designer de dados.

2. Na barra de comandos em Designer de dados, clique na seta ao lado do botão Escreva código, e selecione um método que você deseja substituir.Os métodos que podem ser tratados por seu aplicativo aparecem nas tabelas abaixo.

   Observação
   Os Métodos de propriedade serão exibidos somente na lista suspensa Escreva código se uma propriedade é selecionada em Designer de dados.

   O Editor de Código é aberto.

3. Coloque o cursor no método que foi criado e digite o código que você deseja executar quando o evento ocorre.

Lista de eventos relacionados a dados

As tabelas a seguir listam os eventos de dados que podem ser tratados por seu aplicativo:

Métodos gerais	Descrição
<TableName>_AllowSaveWithErrors	Indica se o item deve ser salvo se o item tem erros de validação.Salvar será anulado por padrão se o item possuir erros de validação.Executa na camada de chamada.
<TableName>_Created	Chamado após o item ser criado.Executa na camada onde o item foi criado.
<TableSetName>_Deleted	Chamado imediatamente após o item ser excluído do armazenamento de dados.Executado no servidor.
<TableSetName>_Deleting	Chamado imediatamente antes do item ser excluído do armazenamento de dados.Executado no servidor.
<TableSetName>_Inserted	Chamado imediatamente após o item ser inserido no armazenamento de dados.Executado no servidor.
<TableSetName>_Inserting	Chamado imediatamente antes do item ser inserido no armazenamento de dados.Executado no servidor.
<TableSetName>_Updated	Chamado imediatamente após o item ser atualizado no armazenamento de dados.Executado no servidor.
<TableSetName>_Updating	Chamado imediatamente antes do item ser atualizado no armazenamento de dados.Executado no servidor.
<TableSetName>_Validate	Chamado quando um item é validado no servidor.

Métodos de controle de acesso	Descrição
SaveChanges_CanExecute	Chamado antes de salvar alterações na fonte de dados para verificar o nível de permissão do usuário atual.Executado no servidor.
<TableSetName>_CanDelete	Chamado antes de excluir um item para verificar o nível de permissão do usuário atual.Executado no servidor.
<TableSetName>_CanInsert	Chamado antes de inserir um item para verificar o nível de permissão do usuário atual.Executado no servidor.
<TableSetName>_CanRead	Chamado antes de ler um item para verificar o nível de permissão do usuário atual.Executado no servidor.
<TableSetName>_CanUpdate	Chamado antes de atualizar um item para verificar o nível de permissão do usuário atual.Executado no servidor.

Métodos de Consulta	Descrição
Query_ExecuteFailed	Chamado depois que a consulta falhar execução.Executado no servidor.
Query_Executed	Chamado imediatamente depois de executar a consulta.Este método é chamado a consulta falha a execução.Executado no servidor.
Query_Executing	Chamado imediatamente antes de executar a consulta.Executado no servidor.
<TableSetName>_Filter	Chamado antes de executar a consulta, permitindo a personalização adicional de consulta.Executado no servidor.

Métodos de fonte de dados	Descrição
SaveChanges_ExecuteFailed	Chamado imediatamente depois de falhar em salvar na fonte de dados.Executado no servidor.
SaveChanges_Executed	Chamado imediatamente após salvar com êxito as alterações na fonte de dados.Executado no servidor.
SaveChanges_Executing	Chamado imediatamente antes de salvar alterações na fonte de dados.Executado no servidor.

Métodos de propriedade
<PropertyName>_Changed	Chamado imediatamente após o valor da propriedade de um item mudar.Executa na camada onde a propriedade foi alterada.
<PropertyName>_IsReadOnly	Retorna se a propriedade é somente leitura.Executa na camada onde a propriedade é acessada.
<PropertyName>_Validate	Chamado quando a propriedade é validada.Executa na camada onde a propriedade é validada.

Consulte também

Tarefas

Como tratar eventos de telas do Silverlight

Como: manipular eventos de consulta

Outros recursos

Dados: Informações por trás de seu aplicativo.