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

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 la 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 de 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:

[!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 Importar y exportar configuraciones en el menú Herramientas.Para obtener más información, vea Valores de configuración de Visual Studio.

Requisitos previos

Para poder completar este tutorial, necesitará:

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

  1. En el menú Archivo, cree un nuevo proyecto.

  2. Asigne al proyecto el nombre UpdateSingleTableWalkthrough.

  3. Seleccione Aplicación para Windows y haga clic en Aceptar.Para obtener más información, vea Desarrollar aplicaciones cliente.

    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

  1. En el menú Datos, haga clic en Mostrar orígenes de datos.

  2. En la ventana Orígenes de datos, haga clic en Agregar nuevo origen de datos para iniciar el Asistente para la configuración de orígenes de datos.

  3. Seleccione Base de datos en la página Elegir un tipo de datos de origen y luego haga clic en Siguiente.

  4. 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.Para obtener más información, vea Agregar/Modificar conexión (Cuadro de diálogo, General).

  5. Si su base de datos requiere una contraseña, seleccione la opción para incluir datos confidenciales y haga clic en Siguiente.

  6. Haga clic en Siguiente en la página Guardar la cadena de conexión en el archivo de configuración de la aplicación.

  7. Expanda el nodo Tablas en la página Elegir los objetos de base de datos.

  8. 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 deben 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

  1. Expanda el nodo Customers en la ventana Orígenes de datos.

  2. 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

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 que se ajuste a las necesidades de su aplicación.

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

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

  2. 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

  1. Presione F5.

  2. Realice algunos cambios a los datos de uno o más registros.

  3. Presione el botón Guardar.

  4. 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 se podrían realizar en este tutorial se incluyen:

Vea también

Conceptos

Novedades de desarrollo de aplicaciones de datos en Visual Studio 2012

Enlazar controles de Windows Forms a datos en Visual Studio

Preparar la aplicación para recibir datos

Buscar datos en la aplicación

Enlazar controles a los datos en Visual Studio

Modificar datos en la aplicación

Validar datos

Guardar datos

Otros recursos

Tutoriales sobre datos

Conectarse a datos en Visual Studio