Cómo: Implementar una actualización jerárquica en proyectos de Visual Studio existentes
Actualización: noviembre 2007
En Visual Studio 2008, se han mejorado los conjuntos de datos con tipo mediante un nuevo 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 de Visual Studio) 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
.gif "Nota") 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
Abra el proyecto que contiene un conjunto de datos con tipo o conjuntos de datos en Visual Studio 2008.
Se abre el Asistente de conversión de Visual Studio.
Siga el Asistente para la conversión de Visual Studio hasta el final.
Abra el conjunto de datos en el Diseñador de DataSet haciendo doble clic en el archivo .xsd en Explorador de soluciones.
Haga clic en un área vacía del Diseñador de DataSet.
Busque la propiedad Actualización jerárquica en la Propiedades (Ventana).
Establezca el valor de la propiedad Actualización jerárquica en True.
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
Busque el código que llama a los métodos TableAdapter.Update (por ejemplo, CustomersTableAdapter.Update(NorthwindDataSet.Customers)).
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
Abra el formulario en la vista Diseño.
Arrastre un componente TableAdapterManager del Cuadro de herramientas al formulario.
Busque el código que llama a los métodos TableAdapter.Update (por ejemplo, CustomersTableAdapter.Update(NorthwindDataSet.Customers)).
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);