Cómo: Controlar eventos de datos

Puede personalizar su aplicación mediante la escritura de código que se ejecute cuando ocurran ciertos eventos de datos. Por ejemplo, puede escribir código que se ejecute cuando se creen, se tenga acceso, se modifiquen o se eliminen las filas de datos de una tabla. También puede escribir código para comprobar si un usuario tiene permiso para modificar el origen de datos.

Los eventos que puede administrar se agrupan en seis categorías:

• Métodos generales que se ejecutan cuando se crean, eliminan o modifican datos.

• Métodos de control de acceso que se ejecutan cuando se crean, eliminan o modifican datos.

• Métodos de consulta que se ejecutan cuando se consulta un origen de datos.

• Métodos de origen de datos que se ejecutan cuando se guarda en un origen de datos.

• Métodos de propiedad que se ejecutan cuando se modifica una propiedad.

La descripción de estos métodos se encuentra en las tablas al final de este tema.

Para administrar un evento relacionado con datos

1. En el Explorador de soluciones, haga doble clic en una entidad o tabla.

   Se abre la tabla o entidad en el Diseñador de datos.

2. En la barra de comandos del Diseñador de datos, haga clic en la flecha situada junto al botón Escribir código y, a continuación, seleccione el método que desea invalidar. En las siguientes tablas se muestran los métodos que puede administrar la aplicación:

   Nota

   Los métodos de propiedad solo aparecen en la lista desplegable Escribir código si una propiedad está seleccionada en el Diseñador de datos.

   Se abre el Editor de código.

3. Coloque el cursor en el método que acaba de crear y escriba el código que desea ejecutar cuando se produzca el evento.

Lista de eventos relacionados con datos

En las siguientes tablas se muestran los eventos de datos que puede administrar la aplicación:

Métodos generales	Descripción
<NombreTabla>_AllowSaveWithErrors	Indica si el elemento debe guardarse aunque tenga errores de validación. La operación de guardar se anula de forma predeterminada si el elemento contiene errores de validación. Se ejecuta en el nivel de llamada.
<NombreTabla>_Created	Se llama después de crear el elemento. Se ejecuta en el nivel donde se creó el elemento.
<NombreConjuntoTabla>_Deleted	Se llama justo después de eliminar el elemento del almacén de datos. Se ejecuta en el servidor.
<NombreConjuntoTabla>_Deleting	Se llama justo antes de eliminar el elemento del almacén de datos. Se ejecuta en el servidor.
<NombreConjuntoTabla>_Inserted	Se llama justo después de insertar el elemento en el almacén de datos. Se ejecuta en el servidor.
<NombreConjuntoTabla>_Inserting	Se llama justo antes de insertar el elemento en el almacén de datos. Se ejecuta en el servidor.
<NombreConjuntoTabla>_Updated	Se llama justo después de actualizar el elemento en el almacén de datos. Se ejecuta en el servidor.
<NombreConjuntoTabla>_Updating	Se llama justo antes de actualizar el elemento en el almacén de datos. Se ejecuta en el servidor.
<NombreConjuntoTabla>_Validate	Se llama cuando se valida un elemento en el servidor.

Métodos de control de acceso	Descripción
SaveChanges_CanExecute	Se le llama antes de guardar los cambios en el origen de datos para comprobar el nivel de permisos del usuario actual. Se ejecuta en el servidor.
<NombreConjuntoTabla>_CanDelete	Se le llama antes de eliminar un elemento para comprobar el nivel de permisos del usuario actual. Se ejecuta en el servidor.
<NombreConjuntoTabla>_CanInsert	Se le llama antes de insertar un elemento para comprobar el nivel de permisos del usuario actual. Se ejecuta en el servidor.
<NombreConjuntoTabla>_CanRead	Se le llama antes de leer un elemento para comprobar el nivel de permisos del usuario actual. Se ejecuta en el servidor.
<NombreConjuntoTabla>_CanUpdate	Se le llama antes de actualizar un elemento para comprobar el nivel de permisos del usuario actual. Se ejecuta en el servidor.

Métodos de consulta	Descripción
Query_ExecuteFailed	Se le llama después de producirse un error en la ejecución de la consulta. Se ejecuta en el servidor.
Query_Executed	Se le llama después de ejecutar la consulta. No se llama a este método si se produce un error en la ejecución de la consulta. Se ejecuta en el servidor.
Query_Executing	Se le llama antes de ejecutar la consulta. Se ejecuta en el servidor.
<NombreConjuntoTabla>_Filter	Se le llama antes de que la consulta se ejecute, lo que permite personalizarla aún más. Se ejecuta en el servidor.

Métodos de origen de datos	Descripción
SaveChanges_ExecuteFailed	Se le llama después de producirse un error al guardar el origen de datos. Se ejecuta en el servidor.
SaveChanges_Executed	Se llama justo después de guardar los cambios correctamente en el origen de datos. Se ejecuta en el servidor.
SaveChanges_Executing	Se llama justo antes de guardar los cambios en el origen de datos. Se ejecuta en el servidor.

Métodos de propiedades
<NombrePropiedad>_Changed	Se llama justo después de cambiar el valor de propiedad de un elemento. Se ejecuta en el nivel donde se cambió la propiedad.
<NombrePropiedad>_IsReadOnly	Devuelve si la propiedad es de solo lectura. Se ejecuta en el nivel donde se tiene acceso a la propiedad.
<NombrePropiedad>_Validate	Se llama cuando se valida la propiedad. Se ejecuta en el nivel donde se valida la propiedad.

Vea también

Tareas

Cómo: Controlar los eventos de pantalla de Silverlight

Cómo: Controlar eventos de consulta

Otros recursos

Datos: La información que hay detrás de la aplicación