Guardar los datos con el TableAdapter DBDirect métodosSave data with the TableAdapter DBDirect methods

Este tutorial proporciona instrucciones detalladas para ejecutar instrucciones SQL directamente en una base de datos mediante los métodos DBDirect de un TableAdapter.This walkthrough provides detailed instructions for running SQL statements directly against a database by using the DBDirect methods of a TableAdapter. Los métodos DBDirect de un TableAdapter proporcionan un nivel exhaustivo de control sobre las actualizaciones de base de datos.The DBDirect methods of a TableAdapter provide a fine level of control over your database updates. Puede usarlas para ejecutar instrucciones SQL específicas y procedimientos almacenados mediante una llamada a la persona Insert, Update, y Delete métodos según sea necesario por la aplicación (en lugar de sobrecargado Update método que realiza la actualización Instrucciones INSERT y DELETE en una llamada).You can use them to run specific SQL statements and stored procedures by calling the individual Insert, Update, and Delete methods as needed by your application (as opposed to the overloaded Update method that performs the UPDATE, INSERT, and DELETE statements all in one call).

Durante este tutorial aprenderá a:During this walkthrough, you will learn how to:

Requisitos previosPrerequisites

Este tutorial usa SQL Server Express LocalDB y la base de datos de ejemplo Northwind.This walkthrough uses SQL Server Express LocalDB and the Northwind sample database.

  1. Si no tiene SQL Server Express LocalDB, puede instalarlo desde el página de descarga de SQL Server Express, o a través del instalador de Visual Studio.If you don't have SQL Server Express LocalDB, install it either from the SQL Server Express download page, or through the Visual Studio Installer. El instalador de Visual Studio, se puede instalar SQL Server Express LocalDB como parte de la almacenamiento de datos y el procesamiento carga de trabajo, o como un componente individual.In the Visual Studio Installer, SQL Server Express LocalDB can be installed as part of the Data storage and processing workload, or as an individual component.

  2. Instalar la base de datos de ejemplo Northwind, siga estos pasos:Install the Northwind sample database by following these steps:

    1. En Visual Studio, abra el Explorador de objetos de SQL Server ventana.In Visual Studio, open the SQL Server Object Explorer window. (Explorador de objetos de SQL Server se instala como parte de la almacenamiento de datos y el procesamiento carga de trabajo en el instalador de Visual Studio.) Expanda el SQL Server nodo.(SQL Server Object Explorer is installed as part of the Data storage and processing workload in the Visual Studio Installer.) Expand the SQL Server node. Haga doble clic en la instancia de LocalDB y seleccione nueva consulta... .Right-click on your LocalDB instance and select New Query....

      Se abre una ventana del editor de consultas.A query editor window opens.

    2. Copia la script Transact-SQL de Northwind en el Portapapeles.Copy the Northwind Transact-SQL script to your clipboard. Este script de T-SQL crea la base de datos Northwind desde el principio y lo rellena con datos.This T-SQL script creates the Northwind database from scratch and populates it with data.

    3. Pegue el script de T-SQL en el editor de consultas y, a continuación, elija la Execute botón.Paste the T-SQL script into the query editor, and then choose the Execute button.

      Después de unos minutos, finaliza la ejecución de la consulta y se crea la base de datos Northwind.After a short time, the query finishes executing and the Northwind database is created.

Crear una aplicación de formularios Windows FormsCreate a Windows Forms application

El primer paso es crear un aplicación de Windows Forms.The first step is to create a Windows Forms Application.

Para crear el nuevo proyecto de WindowsTo create the new Windows project

  1. En Visual Studio, en el archivo menú, seleccione New, proyecto... .In Visual Studio, on the File menu, select New, Project....

  2. Expanda Visual C# o Visual Basic en el panel izquierdo, seleccione escritorio clásico de Windows.Expand either Visual C# or Visual Basic in the left-hand pane, then select Windows Classic Desktop.

  3. En el panel central, seleccione la aplicación de Windows Forms tipo de proyecto.In the middle pane, select the Windows Forms App project type.

  4. Denomine el proyecto nombre TableAdapterDbDirectMethodsWalkthroughy, a continuación, elija Aceptar.Name the project TableAdapterDbDirectMethodsWalkthrough, and then choose OK.

    El nombre TableAdapterDbDirectMethodsWalkthrough se crea y se agrega al proyecto el Explorador de soluciones.The TableAdapterDbDirectMethodsWalkthrough project is created and added to Solution Explorer.

Crear un origen de datos de la base de datosCreate a data source from your database

Este paso se utiliza el Asistente para configuración de orígenes de datos para crear un origen de datos basado en la Region tabla en la base de datos de ejemplo Northwind.This step uses the Data Source Configuration Wizard to create a data source based on the Region table in the Northwind sample database. Debe tener acceso a la base de datos de ejemplo Northwind para crear la conexión.You must have access to the Northwind sample database to create the connection. Para obtener información acerca de cómo configurar la base de datos de ejemplo Northwind, vea Cómo: instalar bases de datos de ejemplo.For information about setting up the Northwind sample database, see How to: Install Sample Databases.

Para crear el origen de datosTo create the data source

  1. En el datos menú, seleccione Mostrar orígenes de datos.On the Data menu, select Show Data Sources.

  2. En el orígenes de datos ventana, seleccione Agregar nuevo origen de datos para iniciar el Asistente para configuración de orígenes de datos.In the Data Sources window, select Add New Data Source to start the Data Source Configuration Wizard.

  3. En el elegir un tipo de origen de datos pantalla, seleccione base de datosy, a continuación, seleccione siguiente.On the Choose a Data Source Type screen, select Database, and then select Next.

  4. En el elegir la conexión de datos pantalla, realice una de las siguientes acciones:On the Choose your Data Connection screen, do one of the following:

    • Si una conexión de datos a la base de datos de ejemplo Northwind está disponible en la lista desplegable, selecciónela.If a data connection to the Northwind sample database is available in the drop-down list, select it.

      O bien-or-

    • Seleccione nueva conexión para iniciar el agregar o modificar conexión cuadro de diálogo.Select New Connection to launch the Add/Modify Connection dialog box.

  5. Si la base de datos requiere una contraseña, seleccione la opción para incluir datos confidenciales y, a continuación, seleccione siguiente.If your database requires a password, select the option to include sensitive data, and then select Next.

  6. En el Guardar cadena de conexión en el archivo de configuración de la aplicación pantalla, seleccione siguiente.On the Save connection string to the Application Configuration file screen, select Next.

  7. En el elija los objetos de base de datos pantalla, expanda la tablas nodo.On the Choose your Database Objects screen, expand the Tables node.

  8. Seleccione el Region de tabla y, a continuación, seleccione finalizar.Select the Region table, and then select Finish.

    El NorthwindDataSet se agrega al proyecto y la Region tabla aparece en la orígenes de datos ventana.The NorthwindDataSet is added to your project and the Region table appears in the Data Sources window.

Agregar controles al formulario para mostrar los datosAdd controls to the form to display the data

Crear los controles enlazados a datos arrastrando elementos desde la orígenes de datos ventana hasta el formulario.Create the data-bound controls by dragging items from the Data Sources window onto your form.

Para crear datos enlazados a controles en el formulario Windows FormsTo create data bound controls on the Windows form

Para agregar botones que llamarán a los métodos DbDirect de TableAdapterTo add buttons that will call the individual TableAdapter DbDirect methods

  1. Arrastre tres Button controla desde el cuadro de herramientas en Form1 (debajo de la RegionDataGridView).Drag three Button controls from the Toolbox onto Form1 (below the RegionDataGridView).

  2. Establece las siguientes opciones nombre y texto propiedades en cada botón.Set the following Name and Text properties on each button.

    nombreName TextoText
    InsertButton InsertarInsert
    UpdateButton ActualizarUpdate
    DeleteButton EliminarDelete

Para agregar código para insertar nuevos registros en la base de datosTo add code to insert new records into the database

  1. Seleccione InsertButton para crear un controlador de eventos para el evento de clic y abrir el formulario en el editor de código.Select InsertButton to create an event handler for the click event and open your form in the code editor.

  2. Reemplace el controlador de evento InsertButton_Click con el código siguiente:Replace the InsertButton_Click event handler with the following code:

    Private Sub InsertButton_Click() Handles InsertButton.Click
    
        Dim newRegionID As Integer = 5
        Dim newRegionDescription As String = "NorthEastern"
    
        Try
            RegionTableAdapter1.Insert(newRegionID, newRegionDescription)
    
        Catch ex As Exception
            MessageBox.Show("Insert Failed")
        End Try
    
        RefreshDataset()
    End Sub
    
    
    Private Sub RefreshDataset()
        Me.RegionTableAdapter1.Fill(Me.NorthwindDataSet1._Region)
    End Sub
    
    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);
    }
    

Para agregar código para actualizar los registros de la base de datosTo add code to update records in the database

  1. Haga doble clic en el UpdateButton para crear un controlador de eventos para el evento de clic y abrir el formulario en el editor de código.Double-click the UpdateButton to create an event handler for the click event and open your form in the code editor.

  2. Reemplace el controlador de evento UpdateButton_Click con el código siguiente:Replace the UpdateButton_Click event handler with the following code:

    Private Sub UpdateButton_Click() Handles UpdateButton.Click
    
        Dim newRegionID As Integer = 5
    
        Try
            RegionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern")
    
        Catch ex As Exception
            MessageBox.Show("Update Failed")
        End Try
    
        RefreshDataset()
    End Sub
    
    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 datosTo add code to delete records from the database

  1. Seleccione DeleteButton para crear un controlador de eventos para el evento de clic y abrir el formulario en el editor de código.Select DeleteButton to create an event handler for the click event and open your form in the code editor.

  2. Reemplace el controlador de evento DeleteButton_Click con el código siguiente:Replace the DeleteButton_Click event handler with the following code:

    Private Sub DeleteButton_Click() Handles DeleteButton.Click
    
        Try
            RegionTableAdapter1.Delete(5, "Updated Region Description")
    
        Catch ex As Exception
            MessageBox.Show("Delete Failed")
        End Try
    
        RefreshDataset()
    End Sub
    
    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ónRun the application

Para ejecutar la aplicaciónTo run the application

  • Seleccione F5 para ejecutar la aplicación.Select F5 to run the application.

  • Seleccione el insertar botón y compruebe que el nuevo registro aparece en la cuadrícula.Select the Insert button, and verify that the new record appears in the grid.

  • Seleccione el actualización botón y compruebe que el registro se actualiza en la cuadrícula.Select the Update button, and verify that the record is updated in the grid.

  • Seleccione el eliminar botón y compruebe que el registro se quita de la cuadrícula.Select the Delete button, and verify that the record is removed from the grid.

Pasos siguientesNext Steps

Dependiendo de los requisitos de la aplicación, hay varios pasos que podría desear realizar después de crear un formulario enlazado a datos.Depending on your application requirements, there are several steps you might want to perform after creating a data-bound form. Entre las mejoras que podría realizar se incluyen:Some enhancements you could make to this walkthrough include:

  • Agregar funcionalidad de búsqueda al formulario.Adding search functionality to the form.

  • Agregar tablas adicionales al conjunto de datos seleccionando configurar DataSet con el asistente desde el orígenes de datos ventana.Adding additional tables to the dataset by selecting Configure DataSet with Wizard from within the Data Sources window. Puede agregar controles que muestren los datos relacionados arrastrando los nodos relacionados al formulario.You can add controls that display related data by dragging the related nodes onto the form. Para obtener más información, consulte relaciones en conjuntos de datos.For more information, see Relationships in Datasets.

Vea tambiénSee Also

Guardar los datos de nuevo en la base de datosSave data back to the database