Tutorial: Pasar datos entre formularios Windows Forms
Publicado: abril de 2016
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 Establecer el control que se creará al arrastrar desde la ventana 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 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
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 delCustomerID
. 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
:internal void LoadOrders(String CustomerID) { ordersTableAdapter.FillByCustomerID(northwindDataSet.Orders, CustomerID); }
Friend Sub LoadOrders(ByVal CustomerID As String) OrdersTableAdapter.FillByCustomerID(NorthwindDataSet.Orders, CustomerID) End Sub
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 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(); }
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
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.
Vea también
Tutoriales sobre datos
Enlazar controles de Windows Forms a datos en Visual Studio
Información general sobre orígenes de datos
Información general sobre TableAdapter
Conectarse 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