Como tratar eventos de dados
Você pode personalizar seu aplicativo gravando um código executado quando determinados eventos de dados ocorrem. Por exemplo, você pode gravar código que será executado quando as linhas de dados em uma tabela forem criadas, acessadas, modificadas ou excluídas. Você também pode gravar código para verificar se um usuário tem permissão para modificar a fonte de dados.
Os eventos que você pode identificar podem ser agrupados em seis categorias:
Métodos gerais executados quando os dados são criados, excluídos ou modificados.
Métodos de controle de acesso executados quando os dados são criados, excluídos ou modificados.
Métodos de consulta executados quando uma fonte de dados é consultada.
Métodos de fonte de dados executados quando uma fonte de dados é salva.
Métodos de propriedades executados quando uma propriedade é modificada.
Uma descrição desses métodos aparece nas tabelas ao final deste tópico.
Para identificar um evento relacionado a dados
No Gerenciador de Soluções, clique duas vezes em uma entidade ou em uma tabela.
A entidade ou a tabela é aberta no Designer de Dados.
Na barra de comandos no Designer de Dados, clique na seta ao lado do botão Gravar Código e selecione um método que você queira substituir. Os métodos que podem ser identificados por seu aplicativo aparecem nas tabelas abaixo.
Dica
Os Métodos de Propriedade só serão exibidos na lista suspensa Gravar Código se uma propriedade for selecionada no Designer de Dados.
O Editor de Códigos é aberto.
Coloque o cursor no método recém-criado e digite o código que você deseja executar quando o evento ocorrer.
Lista de eventos relacionados a dados
As tabelas a seguir listam os eventos de dados que podem ser identificados por seu aplicativo:
Métodos gerais |
Descrição |
|---|---|
<TableName>_AllowSaveWithErrors |
Indica se o item deve ser salvo se tiver erros de validação. A gravação será anulada por padrão se o item tiver erros de validação. Executado na camada de chamada. |
<TableName>_Created |
Chamado após o item ser criado. Executado na camada onde o item foi criado. |
<TableSetName>_Deleted |
Chamado logo depois do item ser excluído do repositório de dados. Executado no servidor. |
<TableSetName>_Deleting |
Chamado pouco antes do item ser excluído do repositório de dados. Executado no servidor. |
<TableSetName>_Inserted |
Chamado logo depois do item ser inserido no repositório de dados. Executado no servidor. |
<TableSetName>_Inserting |
Chamado pouco antes do item ser inserido no repositório de dados. Executado no servidor. |
<TableSetName>_Updated |
Chamado logo depois do item ser atualizado no repositório de dados. Executado no servidor. |
<TableSetName>_Updating |
Chamado pouco antes do item ser atualizado no repositório 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 na execução. Executado no servidor. |
Query_Executed |
Chamado logo depois de executar a consulta. Esse método será chamado se a consulta falhar na execução. Executado no servidor. |
Query_Executing |
Chamado pouco antes da execução da consulta. Executado no servidor. |
<TableSetName>_Filter |
Chamado antes de executar a consulta, permitindo a personalização adicional de consulta. Executado no servidor. |
Métodos da fonte de dados |
Descrição |
|---|---|
SaveChanges_ExecuteFailed |
Chamado logo depois de falhar na gravação na fonte de dados. Executado no servidor. |
SaveChanges_Executed |
Chamado logo depois de salvar com êxito as alterações na fonte de dados. Executado no servidor. |
SaveChanges_Executing |
Chamado pouco antes de salvar alterações na fonte de dados. Executado no servidor. |
Métodos de propriedade |
|
|---|---|
<PropertyName>_Changed |
Chamado logo depois do valor da propriedade de um item mudar. Executado na camada onde a propriedade foi alterada. |
<PropertyName>_IsReadOnly |
Retorna se a propriedade é somente leitura. Executado na camada onde a propriedade é acessada. |
<PropertyName>_Validate |
Chamado quando a propriedade é validada. Executado na camada onde a propriedade é validada. |
Consulte também
Tarefas
Como tratar eventos de telas do Silverlight
Como tratar eventos de consulta