Compartir a través de

Guardar datos con los métodos DBDirect de TableAdapter en aplicaciones de .NET Framework

Nota:

La DataSet clase y las clases relacionadas son tecnologías heredadas de .NET Framework de principios de los años 2000 que permiten a las aplicaciones trabajar con datos en memoria mientras las aplicaciones están desconectadas de la base de datos. Las tecnologías son especialmente útiles para las aplicaciones que permiten a los usuarios modificar datos y conservar los cambios de nuevo en la base de datos. Aunque los conjuntos de datos son una tecnología probada de éxito, el enfoque recomendado para las nuevas aplicaciones .NET es usar Entity Framework Core. Entity Framework proporciona una manera más natural de trabajar con datos tabulares como modelos de objetos y tiene una interfaz de programación más sencilla.

En este tutorial se proporcionan instrucciones detalladas para ejecutar instrucciones SQL directamente en una base de datos mediante los métodos DBDirect de tableAdapter. Los métodos DBDirect de un TableAdapter proporcionan un nivel preciso de control sobre las actualizaciones de la base de datos. Puede usarlos para ejecutar instrucciones SQL específicas y procedimientos almacenados llamando a los métodos individuales Insert, Updatey Delete según sea necesario por la aplicación (en lugar del método sobrecargado Update que realiza las UPDATEinstrucciones , INSERTy DELETE en una sola llamada).

Durante este tutorial, aprenderá a:

Prerrequisitos

Los pasos de este tutorial funcionan con aplicaciones de Windows Forms de .NET Framework.

En este tutorial se usa SQL Server Express LocalDB y la base de datos de ejemplo Northwind.

  1. Si no tiene SQL Server Express LocalDB, instálelo desde la página de descarga de SQL Server Express o mediante el Instalador de Visual Studio. En el instalador de Visual Studio , puede instalar SQL Server Express LocalDB como parte de la carga de trabajo de almacenamiento y procesamiento de datos , o como componente individual.

  2. Instale la base de datos de ejemplo Northwind siguiendo estos pasos:

    1. En Visual Studio, abra la ventana Explorador de objetos de SQL Server (El Explorador de objetos de SQL Server se instala como parte de la carga de trabajo Almacenamiento y procesamiento de datos en el Instalador de Visual Studio). Expanda el nodo SQL Server . Haga clic con el botón derecho en la instancia de LocalDB y seleccione Nueva consulta.

      Se abre una ventana del editor de consultas.

    2. Copie el script Northwind Transact-SQL en su Portapapeles. Este script de T-SQL crea la base de datos Northwind desde cero y la rellena con datos.

    3. Pegue el script T-SQL en el editor de consultas y, a continuación, elija el botón Ejecutar.

      Después de un breve tiempo, la consulta finaliza la ejecución y se crea la base de datos Northwind.

Crear una aplicación de Windows Forms

El primer paso es crear una aplicación de Windows Forms (.NET Framework). Cree un proyecto con el tipo de proyecto Aplicación de Windows Forms mediante C# o Visual Basic.

Nota:

El código de este tutorial está disponible en C# y Visual Basic. Para cambiar el lenguaje de código de esta página entre C# y Visual Basic, use el modificador de lenguaje de código en la parte superior de la página del lado derecho.

Creación de un origen de datos a partir de la base de datos

En este paso se utiliza el Asistente para la configuración del origen de datos para crear un origen de datos basado en la tabla Region de la base de datos de muestra Northwind. Debe tener acceso a la base de datos de ejemplo Northwind para crear la conexión. Para obtener información sobre cómo configurar 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 , seleccione Mostrar orígenes de datos.

    Se abre la ventana Orígenes de datos .

  2. En la ventana Orígenes de datos , seleccione Agregar nuevo origen de datos para iniciar el Asistente para configuración del origen de datos.

  3. En la pantalla Elegir un tipo de origen de datos, seleccione Base de datos y, a continuación, seleccione Siguiente.

  4. En la pantalla Elegir la conexión de datos , realice una de las siguientes acciones:

    • Si hay disponible una conexión de datos a la base de datos de ejemplo Northwind en la lista desplegable, selecciónela.

      O bien:

    • Seleccione Nueva conexión para iniciar el cuadro de diálogo Agregar o modificar conexión .

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

  6. En la pantalla Guardar cadena de conexión en el archivo de configuración de la aplicación , seleccione Siguiente.

  7. En la pantalla Elegir los objetos de base de datos , expanda el nodo Tablas .

  8. Seleccione la Region tabla y, a continuación, seleccione Finalizar.

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

Agregar controles al formulario para mostrar los datos

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

Para crear controles enlazados a datos en windows form, arrastre el nodo Región principal desde la ventana Orígenes de datos hasta el formulario.

Un DataGridView control y una franja de herramientas (BindingNavigator) para navegar por los registros aparecen en el formulario. Un NorthwindDataSet, RegionTableAdapter, BindingSource y BindingNavigator aparecen en la bandeja de componentes.

Para agregar botones que llamarán a los métodos individuales de TableAdapter DbDirect

  1. Arrastre tres Button controles desde el Cuadro de herramientas a Form1 (debajo de RegionDataGridView).

  2. Establezca las siguientes propiedades Name y Text en cada botón.

    Nombre Mensaje de texto
    InsertButton Insertar
    UpdateButton Actualizar
    DeleteButton Eliminar

Para agregar código para insertar nuevos registros en la base de datos

  1. Seleccione InsertarButton para crear un controlador de eventos para el evento click y abra el formulario en el editor de código.

  2. Reemplace el InsertButton_Click controlador de eventos por el código siguiente:

    private void InsertButton_Click(object sender, EventArgs e)
{
    Int32 newRegionID = 5;
    String newRegionDescription = "NorthEastern";

    try
    {
        regionTableAdapter1.Insert(newRegionID, newRegionDescription);
    }
    catch (Exception ex)
    {
        MessageBox.Show("Insert Failed");
    }
    RefreshDataset();
}


private void RefreshDataset()
{
    this.regionTableAdapter1.Fill(this.northwindDataSet1.Region);
}

    Nota:

    Según la versión de Visual Studio y las plantillas de proyecto que usó, los nombres de variable como regionTableAdapter o regionTableAdapter1 que se usan en este código podrían tener o no un final 1 en el código generado. Realice cualquier corrección en el código para asegurarse de que el nombre correcto se usa en todas partes. Visual Studio muestra un subrayado ondulado rojo donde el nombre es incorrecto.

Para agregar código para actualizar registros en la base de datos

  1. Haga doble clic en updateButton para crear un controlador de eventos para el evento click y abra el formulario en el editor de código.

  2. Reemplace el UpdateButton_Click controlador de eventos por el código siguiente:

    private void UpdateButton_Click(object sender, EventArgs e)
{
    Int32 newRegionID = 5;
    
    try
    {
        regionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern");
    }
    catch (Exception ex)
    {
        MessageBox.Show("Update Failed");
    }
    RefreshDataset();
}

Para agregar código para eliminar registros de la base de datos

  1. Seleccione DeleteButton para crear un controlador de eventos para el evento click y abra el formulario en el editor de código.

  2. Reemplace el DeleteButton_Click controlador de eventos por el código siguiente:

    private void DeleteButton_Click(object sender, EventArgs e)
{
    try
    {
        regionTableAdapter1.Delete(5, "Updated Region Description");
    }
    catch (Exception ex)
    {
        MessageBox.Show("Delete Failed");
    }
    RefreshDataset();
}

Ejecutar la aplicación

  • Seleccione F5 para ejecutar la aplicación.

  • Seleccione el botón Insertar y compruebe que el nuevo registro aparece en la cuadrícula.

  • Seleccione el botón Actualizar y compruebe que el registro se actualiza en la cuadrícula.

  • Seleccione el botón Eliminar y compruebe que el registro se quita de la cuadrícula.

Pasos siguientes

En función de los requisitos de la aplicación, es posible que desee realizar varios pasos después de crear un formulario enlazado a datos. Algunas mejoras que podría realizar en este tutorial incluyen:

  • Adición de la funcionalidad de búsqueda al formulario.

  • Para agregar tablas adicionales al conjunto de datos, seleccione Configurar conjunto de datos con el Asistente en la ventana Orígenes de datos . Puede agregar controles que muestren datos relacionados arrastrando los nodos relacionados al formulario. Para obtener más información, consulte Relaciones en conjuntos de datos.

Contenido relacionado

  • Last updated on