Cómo: Implementar una actualización jerárquica en proyectos de Visual Studio existentes

A partir de Visual Studio 2008, los conjuntos de datos con tipo están mejorados con el componente TableAdapterManager. TableAdapterManager reduce el código que se necesita para guardar datos en varias tablas relacionadas de varias rutinas con muchas líneas de código en una única llamada al método: TableAdapterManager.UpdateAll(TypedDataset). De forma predeterminada, la actualización jerárquica está habilitada para todos los nuevos conjuntos de datos que se agregan o se crean en un proyecto. Los conjuntos de datos existentes (conjuntos de datos creados en versiones anteriores a Visual Studio 2008) no contienen un componente TableAdapterManager. Por consiguiente, de forma predeterminada, los conjuntos de datos creados en versiones anteriores tienen la propiedad Actualización jerárquica establecida en False. Para generar los componentes TableAdapterManager, establezca la propiedad Actualización jerárquica en True y guarde el conjunto de datos. Para obtener más información, vea Información general sobre TableAdapterManager.

Habilitar la actualización jerárquica y generar el componente TableAdapterManager

Nota

Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Valores de configuración de Visual Studio.

Para habilitar la actualización jerárquica en versiones anteriores de conjuntos de datos con tipo

  1. Abra el proyecto que contiene un conjunto de datos con tipo o conjuntos de datos en Visual Studio.

  2. Siga el Asistente para la conversión de Visual Studio hasta el final.

  3. Abra el conjunto de datos en el Diseñador de DataSet haciendo doble clic en el archivo .xsd en el Explorador de soluciones.

  4. Haga clic en un área vacía del Diseñador de DataSet.

  5. Busque la propiedad Actualización jerárquica en la Propiedades (ventana).

  6. Establezca el valor de la propiedad Actualización jerárquica en True.

  7. En el menú Generar, haga clic en Generar solución.

Configurar TableAdapterManager y guardar los datos

Al establecer la propiedad Actualización jerárquica en True y guardar el conjunto de datos se genera el componente TableAdapterManager que habilita la actualización jerárquica. Después de generar el componente TableAdapterManager, actualice el código existente para crear instancias de un nuevo componente TableAdapterManager y llamar al método TableAdapterManager.UpdateAll(), en lugar de llamar a los métodos TableAdapter.Update() individuales. Si el código existente de TableAdapter se encuentra en una biblioteca de clases (o en cualquier archivo que no tenga una interfaz de usuario), debe crear instancias de un nuevo componente TableAdapterManager mediante programación. Si el código existente de TableAdapter se encuentra en un formulario, puede crear instancias de un nuevo TableAdapterManager arrastrando un componente TableAdapterManager del Cuadro de herramientas al formulario.

Los componentes TableAdapterManager tienen establecimiento inflexible de tipos; es decir, se generan con propiedades que hacen referencia a los componentes TableAdapter individuales que administran. Después de crear una instancia de TableAdapterManager, establezca las propiedades individuales de TableAdapter en las instancias de cada TableAdapter, como se muestra en los procedimientos siguientes.

Para agregar TableAdapterManager a un proyecto existente sin una interfaz de usuario

  1. Busque el código que llama a los métodos TableAdapter.Update (por ejemplo, CustomersTableAdapter.Update(NorthwindDataSet.Customers)).

  2. Reemplace el código que llama a los métodos TableAdapter.Update individuales con el siguiente:

    Dim adapterManager as new TableAdapterManager
    adapterManager.TableName1TableAdapter = new _
    TableName1TableAdapter
    adapterManager.TableName2TableAdapter = new _
    TableName2TableAdapter
    
    adapterManager.UpdateAll(Me.DataSetName)
    
    TableAdapterManager adapterManager = 
    new TableAdapterManager();
    
    adapterManager.TableName1TableAdapter = 
    new TableName1TableAdapter();
    adapterManager.TableName2TableAdapter = 
    new TableName2TableAdapter();
    
    adapterManager.UpdateAll(this.DataSetName);
    

Para agregar TableAdapterManager a un proyecto existente que tiene una interfaz de usuario

  1. Abra el formulario en la vista Diseño.

  2. Arrastre un componente TableAdapterManager del Cuadro de herramientas al formulario.

  3. Busque el código que llama a los métodos TableAdapter.Update (por ejemplo, CustomersTableAdapter.Update(NorthwindDataSet.Customers)).

  4. Reemplace el código que llama a los métodos TableAdapter.Update individuales con el siguiente:

    Me.TableAdapterManager.TableName1TableAdapter = _
    new DatasetNameTableAdapters.TableName1TableAdapter
    Me.TableAdapterManager.TableName2TableAdapter = _
    new DatasetNameTableAdapters.TableName2TableAdapter
    
    Me.TableAdapterManager.UpdateAll(Me.DataSetName)
    
    TableAdapterManager.TableName1TableAdapter = new 
    TableName1TableAdapter();
    TableAdapterManager.TableName2TableAdapter = new 
    TableName2TableAdapter();
    
    TableAdapterManager.UpdateAll(this.DataSetName);
    

Vea también

Conceptos

Novedades en el desarrollo de aplicaciones de datos

Información general sobre la actualización jerárquica

Información general sobre TableAdapterManager