Tutorial: Guardar datos en una base de datos (Tabla única)

Artículo
06/10/2015

Uno de los escenarios más comunes en el desarrollo de aplicaciones consiste en mostrar los datos en un formulario de una aplicación Windows, editar los datos y devolverlos actualizados a la base de datos. Este tutorial crea un formulario simple que muestra los datos de una tabla única en controles individuales. Puede modificar los datos en los controles y guardar en la base de datos los cambios realizados. En este ejemplo se utiliza la tabla Customers de la base de datos de ejemplo Northwind.

Puede guardar los datos de su aplicación en la base de datos llamando al método Update de un TableAdapter. Cuando se arrastran elementos desde la ventana Orígenes de datos, el código para guardar los datos se agrega automáticamente para la primera tabla arrastrada hasta un formulario. Cualquier tabla adicional agregada a un formulario requiere la adición manual del código necesario para guardar los datos. Para obtener información sobre cómo guardar los datos de más de una tabla, vea Tutorial: Guardar datos en una base de datos (Varias tablas).

Las tareas ilustradas en este tutorial incluyen:

Crear un nuevo proyecto Aplicación Windows.
Crear y configurar un origen de datos en la aplicación con el Asistente para la configuración de orígenes de datos.
Establecer los controles de los elementos en Orígenes de datos (ventana). Para obtener más información, vea Cómo: Establecer el control que se creará al arrastrar desde la ventana de orígenes de datos.
Crear controles enlazados a datos arrastrando elementos desde la ventana Orígenes de datos hasta el formulario.
Modificar un par de registros del conjunto de datos.
Agregar código para enviar los datos actualizados del conjunto de registros de vuelta a la base de datos.

Nota

Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos.Para cambiar la configuración, elija la opción Importar y exportar configuraciones del menú Herramientas.Para obtener más información, vea Personalizar la configuración de desarrollo en Visual Studio.

Requisitos previos

Para poder completar este tutorial, necesitará:

Acceso a la base de datos de ejemplo Northwind. Para obtener más información, vea Cómo: Instalar bases de datos de ejemplo.

Crear la aplicación para Windows

El primer paso es crear una Aplicación para Windows. La asignación de un nombre al proyecto es opcional en este paso, pero le vamos a asignar uno porque tenemos previsto guardarlo más adelante.

Para crear el nuevo proyecto de aplicación para Windows

En el menú Archivo, cree un nuevo proyecto.
Asigne al proyecto el nombre UpdateSingleTableWalkthrough.
Seleccione Aplicación para Windows y haga clic en Aceptar. Para obtener más información, vea Desarrollar aplicaciones cliente con .NET Framework.

El proyecto UpdateSingleTableWalkthrough se crea y se agrega al Explorador de soluciones.

Crear el origen de datos

Este paso crea un origen de datos a partir de la base de datos Northwind utilizando el Asistente para la configuración de orígenes de datos. Debe tener acceso a la base de datos de ejemplo Northwind para finalizar el asistente. Para obtener información sobre la configuración de la base de datos de ejemplo Northwind, vea Cómo: Instalar bases de datos de ejemplo.

Para crear el origen de datos

En el menú Datos, haga clic en Mostrar orígenes de datos.
En la ventana Orígenes de datos, haga clic en Agregar nuevo origen de datos para iniciar el Asistente para configuración de orígenes de datos.
Seleccione Base de datos en la página Elegir un tipo de datos de origen y luego haga clic en Siguiente.
En la página Elegir la conexión de datos realice una de las siguientes operaciones:
- Si una conexión de datos a la base de datos de ejemplo Northwind está disponible en la lista desplegable, selecciónela.
  
  O bien
- Seleccione Nueva conexión para abrir el cuadro de diálogo Agregar o modificar conexión.
Si su base de datos requiere una contraseña, seleccione la opción para incluir datos confidenciales y haga clic en Siguiente.
Haga clic en Siguiente en la página Guardar la cadena de conexión en el archivo de configuración de la aplicación.
Expanda el nodo Tables en la página Elija los objetos de base de datos.
Seleccione la tabla Customers y, a continuación, haga clic en Finalizar.

NorthwindDataSet se agrega al proyecto y la tabla Customers aparece en la ventana Orígenes de datos.

Establecer los controles que se van a crear

Para este tutorial los datos estarán en un diseño Detalles donde los datos aparecen en controles individuales en lugar del diseño predeterminado de DataGridView.

Para establecer los controles de los elementos en la ventana Orígenes de datos

Expanda el nodo Customers en la ventana Orígenes de datos.
Cambie el control para la tabla Customers a controles individuales seleccionando Detalles en la lista desplegable del nodo Customers. Para obtener más información, vea Cómo: Establecer el control que se creará al arrastrar desde la ventana de orígenes de datos.

Crear el formulario enlazado a datos

Puede crear los controles enlazados a datos arrastrando elementos desde la ventana Orígenes de datos al formulario.

Para crear controles enlazados en el formulario

Arrastre el nodo Customers principal desde la ventana Orígenes de datos a Form1.

Los controles enlazados a datos con etiquetas descriptivas aparecen en el formulario, junto con una barra de herramientas (BindingNavigator) para navegar por los registros. En la bandeja de componentes aparecen NorthwindDataSet, CustomersTableAdapter, BindingSource y BindingNavigator.

Modificar el código para actualizar la base de datos

Puede actualizar la base de datos llamando al método Update de CustomersTableAdapter. De manera predeterminada, se agrega un controlador de eventos para el botón Guardar de BindingNavigator al código del formulario para enviar las actualizaciones a la base de datos. Este procedimiento modifica el código para que incluya control de errores insertando la llamada de actualización en un bloque try-catch. Puede modificar el código para satisfacer las necesidades de la aplicación.

Para agregar la lógica de actualización a la aplicación

Haga doble clic en el botón Guardar de BindingNavigator para abrir en el Editor de código el controlador del evento bindingNavigatorSaveItem_Click.

Reemplace el código en el controlador de eventos para agregar un control de errores. El código debe tener este aspecto:

Try 
    Me.Validate()
    Me.CustomersBindingSource.EndEdit()
    Me.CustomersTableAdapter.Update(Me.NorthwindDataSet.Customers)
    MsgBox("Update successful")

Catch ex As Exception
    MsgBox("Update failed")
End Try

try
{
    this.Validate();
    this.customersBindingSource.EndEdit();
    this.customersTableAdapter.Update(this.northwindDataSet.Customers);
    MessageBox.Show("Update successful");
}
catch (System.Exception ex)
{
    MessageBox.Show("Update failed");
}

Probar la aplicación

Para probar la aplicación

Presione F5.
Realice algunos cambios a los datos de uno o más registros.
Presione el botón Guardar.
Compruebe los valores de la base de datos para verificar que se guardaron los cambios.

Pasos siguientes

Dependiendo de los requisitos de la aplicación, hay varios pasos que puede que desee realizar después de crear un formulario enlazado a datos en su aplicación para Windows. Entre las mejoras que podría realizar se incluyen:

Agregar funcionalidad de búsqueda al formulario. Para obtener más información, vea Cómo: Agregar una consulta parametrizada a una aplicación de Windows Forms.
Agregar controles que muestran datos relacionados. Para obtener más información, vea Cómo: Mostrar datos relacionados en una aplicación de Windows Forms.
Editar el origen de datos para agregar o quitar objetos de base de datos. Para obtener más información, vea Cómo: Editar un conjunto de datos.