Información general sobre TableAdapterManager
TableAdapterManager es un componente que proporciona la funcionalidad para guardar datos en tablas de datos relacionadas. TableAdapterManager usa las relaciones de clave externa que relacionan las tablas de datos para determinar el orden correcto para enviar las inserciones, actualizaciones y eliminaciones de un conjunto de datos a la base de datos sin infringir las restricciones FOREIGN KEY (integridad referencial) en la base de datos.
Las restricciones FOREIGN KEY son las reglas de coherencia en una base de datos que controlan el comportamiento de insertar, actualizar y eliminar registros relacionados. Son estas restricciones las que evitan que se eliminen los registros primarios mientras permanecen los registros secundarios relacionados en otra tabla.
El proceso completo de guardar los datos en tablas de datos relacionadas mediante TableAdapterManager se denomina Actualización jerárquica.
Guardar los datos modificados de las tablas de datos relacionadas es algo más complejo que guardar los datos en una tabla única. Esto se debe a que los comandos Insert, Update y Delete para cada tabla relacionada tienen que ejecutarse en un orden concreto para evitar infringir las restricciones FOREIGN KEY definidas en la base de datos. Por ejemplo, considere una aplicación de entrada de orden con la que puede administrar tanto los clientes y pedidos nuevos, como los existentes. Si tiene que eliminar un registro de cliente existente, debe eliminar primero todos los pedidos de ese cliente. Si agrega un nuevo registro de cliente (con un pedido), debe insertar el nuevo registro de cliente antes de insertar los pedidos de ese cliente debido a las restricciones FOREIGN KEY de las tablas. Como se muestra en estos ejemplos, debe extraer subconjuntos de datos concretos y enviar las actualizaciones (inserciones, actualizaciones y eliminaciones) en el orden correcto para mantener la integridad referencial y evitar conflictos con las restricciones FOREIGN KEY en la base de datos.
Crear TableAdapterManagers
De forma predeterminada, se genera una clase TableAdapterManager al crear un conjunto de datos con tipo en un proyecto. Más concretamente, es el valor en la propiedad Hierarchical Update de un conjunto de datos que determina si se crea TableAdapterManager. Si Hierarchical Update está establecido en True, se crea TableAdapterManager; si Hierarchical Update está establecido en False, se crea un conjunto de datos que no contiene TableAdapterManager. Para obtener más información, vea Cómo: Habilitar y deshabilitar la actualización jerárquica.
Nota
De forma predeterminada, los conjuntos de datos que se agregan a los proyectos creados en versiones anteriores de Visual Studio tienen la propiedad Hierarchical Update establecida en False. Esto significa que la actualización jerárquica está deshabilitada y no se crea TableAdapterManager. Para obtener información sobre cómo agregar un TableAdapterManager a un conjunto de datos existente, vea Cómo: Implementar una actualización jerárquica en proyectos de Visual Studio existentes.
Referencia de TableAdapterManager
La clase TableAdapterManager no forma parte de .NET Framework. Por consiguiente, no se encuentra en la documentación. Se crea en tiempo de diseño como parte del proceso de creación del conjunto de datos.
A continuación, se muestra los métodos y propiedades de la clase TableAdapterManager usados con más frecuencia:
Miembro |
Descripción |
|---|---|
Método UpdateAll |
Guarda todos los datos de todas las tablas de datos. |
Propiedad BackUpDataSetBeforeUpdate |
Booleano. Determina si se debe crear una copia de seguridad del conjunto de datos antes de ejecutar el método TableAdapterManager.UpdateAll. |
Propiedad TableAdapter de nombreDeTabla |
Representa un TableAdapter. El TableAdapterManager generado contiene una propiedad para cada TableAdapter que administra. Por ejemplo, un conjunto de datos con una tabla Clientes y Pedidos se genera con TableAdapterManager que contiene las propiedades CustomersTableAdapter y OrdersTableAdapter. |
Propiedad UpdateOrder |
Controla el orden de ejecución de los comandos Insert, Update y Delete. Establezca la propiedad en uno de los valores de la enumeración TableAdapterManager.UpdateOrderOption. De forma predeterminada, UpdateOrder se establece en InsertUpdateDelete. Esto indica que las inserciones se realizan para todas las tablas del conjunto de datos, a continuación, se realizan las actualizaciones para todas las tablas del conjunto de datos y, por último, se realizan las eliminaciones para todas las tablas del conjunto de datos. Para obtener más información, vea Cómo: Establecer el orden al realizar una actualización jerárquica. |
Vea también
Tareas
Tutorial: Guardar datos de tablas de datos relacionadas (actualización jerárquica)
Tutorial: Crear una aplicación de datos sencilla
Conceptos
Información general sobre TableAdapter