Compartir a través de


Tutorial: Pasar datos entre formularios Windows Forms

Este tutorial proporciona instrucciones detalladas para pasar datos de un formulario a otro.Utilizando las tablas de clientes (customers) y pedidos (orders) de Northwind, un formulario permitirá a los usuarios seleccionar un cliente y un segundo formulario mostrará los pedidos del cliente seleccionado.Este tutorial muestra cómo crear un método en un formulario que recibe los datos del primer formulario.

[!NOTA]

Este tutorial sólo muestra una manera de pasar datos entre formularios.Existen otras opciones para pasar datos a un formulario, incluidas las siguientes: crear un segundo constructor para recibir datos o crear una propiedad pública que se pueda establecer con datos del primer formulario.

Las tareas ilustradas en este tutorial incluyen:

Requisitos previos

Para completar las tareas de este tutorial, necesitará:

Crear la aplicación para Windows

Para crear el nuevo proyecto de Windows

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

  2. Asigne al proyecto el nombre PassingDataBetweenForms.

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

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

Crear el origen de datos

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, seleccione 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 un modelo de base de datos, compruebe que está especificado Conjunto de datos y, a continuación, haga clic en Siguiente.

  5. 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 iniciar 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).

  6. Si su base de datos requiere una contraseña y si está habilitada la opción de incluir datos confidenciales, seleccione esa opción y haga clic en Siguiente.

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

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

  9. Seleccione las tablas Customers y Orders y, a continuación, haga clic en Finalizar.

    Se agrega NorthwindDataSet al proyecto y las tablas Customers y Orders aparecen en la ventana Orígenes de datos.

Crear el primer formulario (Form1)

Puede crear una cuadrícula enlazada a datos (un control DataGridView) arrastrando el nodo Customers desde la ventana Orígenes de datos hasta el formulario.

Para crear una cuadrícula enlazada a datos en el formulario

Crear el segundo formulario (Form2)

Para crear un segundo formulario al cual pasar los datos

  1. En el menú Proyecto, elija Agregar Windows Form.

  2. Deje el nombre predeterminado de Form2 y haga clic en Agregar.

  3. Arrastre el nodo Orders principal desde la ventana Orígenes de datos hasta Form2.

    En el formulario Form2 aparecen un control DataGridView y una barra de herramientas (BindingNavigator) para navegar por los registros.Aparecen en la bandeja de componentes NorthwindDataSet, CustomersTableAdapter, BindingSource y BindingNavigator.

  4. Elimine OrdersBindingNavigator de la bandeja de componentes.

    El control OrdersBindingNavigator desaparece de Form2.

Agregar una consulta de TableAdapter al Form2 para cargar los pedidos del cliente seleccionado en el Form1

Para crear una consulta de TableAdapter

  1. Haga doble clic en el archivo NorthwindDataSet.xsd en el Explorador de soluciones.

  2. Haga clic con el botón secundario del mouse en OrdersTableAdapter y seleccione Agregar consulta.

  3. Deje la opción predeterminada de Usar instrucciones SQL y, a continuación, haga clic en Siguiente.

  4. Deje la opción predeterminada de SELECT que devuelve filas y, a continuación, haga clic en Siguiente.

  5. Agregue una cláusula WHERE a la consulta para devolver los pedidos (Orders) en función del valor de CustomerID.La consulta debe ser similar a lo siguiente:

    SELECT OrderID, CustomerID, EmployeeID, OrderDate, RequiredDate, ShippedDate, ShipVia, Freight, ShipName, ShipAddress, ShipCity, ShipRegion, ShipPostalCode, ShipCountry
    FROM Orders 
    WHERE CustomerID = @CustomerID
    

    [!NOTA]

    Compruebe la sintaxis de parámetro correcta para la base de datos.Por ejemplo, en Microsoft Access, la cláusula WHERE debe tener este aspecto: WHERE CustomerID = ?.

  6. Haga clic en Siguiente.

  7. Para el Nombre de métodoRellenar un DataTable, escriba FillByCustomerID.

  8. Borre la opción Devolver un DataTable y, a continuación, haga clic en Siguiente.

  9. Haga clic en Finalizar.

Crear un método en el Form2 al cual pasar los datos

Para crear un método al cual pasar los datos

  1. Haga clic con el botón secundario del mouse en el Form2 y seleccione Ver código para abrir el Form2 en el Editor de código.

  2. Agregue el código siguiente a Form2 después del método Form2_Load.

    Friend Sub LoadOrders(ByVal CustomerID As String)
        OrdersTableAdapter.FillByCustomerID(NorthwindDataSet.Orders, CustomerID)
    End Sub
    
    internal void LoadOrders(String CustomerID)
    {
        ordersTableAdapter.FillByCustomerID(northwindDataSet.Orders, CustomerID);
    }
    

Crear un método en el Form1 para pasar los datos y mostrar el Form2

Para crear un método para pasar los datos desde el Form2

  1. En Form1, haga clic con el botón secundario en la cuadrícula de datos de cliente y, a continuación, haga clic en Propiedades.

  2. En la ventana Propiedades, haga clic en el botón Eventos.

  3. Haga doble clic en el evento CellDoubleClick.

    Aparece el editor de código.

  4. Actualice la definición de método para que coincida con el ejemplo siguiente:

    Private Sub CustomersDataGridView_DoubleClick() Handles CustomersDataGridView.DoubleClick
    
        Dim SelectedRowView As Data.DataRowView
        Dim SelectedRow As NorthwindDataSet.CustomersRow
    
        SelectedRowView = CType(CustomersBindingSource.Current, System.Data.DataRowView)
        SelectedRow = CType(SelectedRowView.Row, NorthwindDataSet.CustomersRow)
    
        Dim OrdersForm As New Form2
        OrdersForm.LoadOrders(SelectedRow.CustomerID)
        OrdersForm.Show()
    End Sub
    
    private void customersDataGridView_DoubleClick(object sender, EventArgs e)
    {
        System.Data.DataRowView SelectedRowView;
        NorthwindDataSet.CustomersRow SelectedRow;
    
        SelectedRowView = (System.Data.DataRowView)customersBindingSource.Current;
        SelectedRow = (NorthwindDataSet.CustomersRow)SelectedRowView.Row;
    
        Form2 OrdersForm = new Form2();
        OrdersForm.LoadOrders(SelectedRow.CustomerID);
        OrdersForm.Show();
    }
    

Ejecutar la aplicación

Para ejecutar la aplicación

  • Presione F5 para ejecutar la aplicación.

  • Haga doble clic en un registro de cliente en Form1 para abrir Form2 con los pedidos de ese cliente.

Pasos siguientes

Dependiendo de los requisitos de la aplicación, existen varios pasos que se pueden realizar después de pasar datos entre los formularios.Entre las mejoras que se podrían realizar en este tutorial se incluyen:

Vea también

Conceptos

Enlazar controles de Windows Forms a datos en Visual Studio

Información general sobre orígenes de datos

Información general sobre TableAdapter

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