Tutorial: Pasar datos entre formularios Windows Forms

Artículo
06/10/2015

En este tutorial se proporcionan instrucciones paso a paso para pasar datos de un formulario a otro. Usando las tablas de clientes y pedidos de Northwind, un formulario permitirá a los usuarios seleccionar un cliente y un segundo formulario mostrará los pedidos de los clientes seleccionados. En este tutorial se muestra cómo crear un método en un formulario que recibe datos del primero formulario.

Nota

En este tutorial solo se muestra una manera de pasar datos de un formulario a otro.Hay otras opciones para datos a un formulario, entre ellas las siguientes: puede crear un segundo constructor para recibir datos o puede crear una propiedad pública que se puede establecer con los datos del primer formulario.

Las tareas ilustradas en este tutorial incluyen:

Crear un nuevo proyecto Aplicación Windows.
Crear y configurar un conjunto de datos con el Asistente para la configuración de orígenes de datos.
Seleccionar el control que se va a crear en el formulario al arrastrar elementos desde la ventana Orígenes de datos. 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 un control enlazado a datos arrastrando elementos desde la ventana Orígenes de datos hasta un formulario.
Crear un segundo formulario con una cuadrícula para mostrar datos.
Crear una consulta de TableAdapter para buscar los pedidos de un cliente determinado.
Pasar datos de un formulario a otro.

Requisitos previos

Para completar las tareas de 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

Para crear el nuevo proyecto de Windows

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

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

Crear el origen de datos

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, seleccione 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 un modelo de base de datos, compruebe que se ha especificado Conjunto de datos y 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 iniciar el cuadro de diálogo Agregar o modificar conexión.
Si su base de datos requiere una contraseña y la opción para incluir datos confidenciales está habilitada, seleccione la opción 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 las tablas Customers y Orders y, a continuación, haga clic en Finalizar.

NorthwindDataSet se agrega 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 al formulario.

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

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

En Form1 aparecen DataGridView y una barra de herramientas (BindingNavigator) para navegar por los registros. En la bandeja de componentes aparecen NorthwindDataSet, CustomersTableAdapter, BindingSource y BindingNavigator.

Crear el segundo formulario (Form2)

Para crear un segundo formulario al que pasar los datos

En el menú Proyecto, elija Agregar Windows Forms.
Deje el nombre predeterminado Form2 y haga clic en Agregar.
Arrastre el nodo Orders principal desde la ventana Orígenes de datos a Form2.

En Form2 aparecen DataGridView y una barra de herramientas (BindingNavigator) para navegar por los registros. En la bandeja de componentes aparecen NorthwindDataSet, CustomersTableAdapter, BindingSource y BindingNavigator.
Elimine OrdersBindingNavigator de la bandeja de componentes.

OrdersBindingNavigator desaparece del Form2.

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

Para crear una consulta de TableAdapter

Haga doble clic en el archivo NorthwindDataSet.xsd, en el Explorador de soluciones.
Haga clic con el botón secundario en OrdersTableAdapter y seleccione Agregar consulta.
Deje la opción predeterminada Usar instrucciones SQL y haga clic en Siguiente.
Deje la opción predeterminada SELECT que devuelve filas y haga clic en Siguiente.
Agregue una cláusula WHERE a la consulta para que devuelva Orders en función del 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 que la sintaxis de los parámetros sea correcta para su base de datos.Por ejemplo, en Microsoft Access, la cláusula WHERE tendría el siguiente aspecto: WHERE CustomerID = ?.
Haga clic en Siguiente.
En Rellenar un DataTable, en Nombre del método, escriba FillByCustomerID.
Desactive la opción Devolver un DataTable y haga clic en Siguiente.
Haga clic en Finalizar.

Crear un método en Form2 al que pasar datos

Para crear un método al que pasar datos

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

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 Form1 para pasar datos y mostrarlos en Form2

Para crear un método para pasar datos a Form2

En Form1, haga clic con el botón secundario en la cuadrícula de datos Customer y, después, haga clic en Propiedades.
En la ventana Propiedades, haga clic en Eventos.
Haga doble clic en el evento CellDoubleClick.

Aparece el editor de código.

Actualice la definición del 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 del cliente.

Pasos siguientes

Dependiendo de los requisitos de la aplicación, existen varios pasos que se pueden realizar después de pasar los datos de un formulario a otro. Entre las mejoras que podría realizar se incluyen:

Modificar el conjunto de datos agregando o quitando objetos de la base de datos. Para obtener más información, vea Cómo: Editar un conjunto de datos.
Agregar funcionalidad para guardar los datos de nuevo en la base de datos. Para obtener más información, vea Cómo: Guardar cambios de un conjunto de datos en una base de datos.