Tutorial: Rellenar un conjunto de datos con datos

Artículo
06/10/2015

En este tutorial se crea un conjunto de datos con una tabla de datos, y se rellena con los datos de la tabla Customers de la base de datos de ejemplo Northwind. Para rellenar el conjunto de datos con los datos, se llama al método Fill de un TableAdapter.

Durante este tutorial aprenderá a:

Crear una nueva aplicación para Windows.
Crear y configurar un conjunto de datos con el Asistente para la configuración de orígenes de datos.
Crear una DataGridView enlazada a datos arrastrando elementos desde la ventana Orígenes de datos hasta un formulario.

Requisitos previos

Para poder completar 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 una aplicación para Windows

El primer paso es crear una Aplicación para Windows.

Para crear el nuevo proyecto de Windows

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

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

Crear NorthwindDataSet

En este paso se crea un conjunto de datos usando el Asistente para configuración de orígenes de datos basado en la tabla Customers de la base de datos de ejemplo Northwind. Debe tener acceso a la base de datos de ejemplo Northwind para crear la conexión. Para obtener información sobre la configuración de la base de datos de ejemplo Northwind, vea Cómo: Instalar bases de datos de ejemplo.

Para crear el conjunto de datos

En el menú Datos, haga clic en Mostrar orígenes de datos.
En la ventana Orígenes de datos, haga clic en 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 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, seleccione la opción para incluir datos confidenciales 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 la tabla Customers y, a continuación, haga clic en Finalizar.

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

Agregar controles al formulario

Puede crear controles enlazados a datos arrastrando elementos desde la ventana Orígenes de datos hasta el formulario en su aplicación de Windows.

Para crear una DataGridView enlazada a la tabla Customers

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

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

Inspeccionar el código generado que rellena con datos el conjunto de datos

Al arrastrar elementos desde la ventana Orígenes de datos a un formulario se agrega automáticamente el código correcto para rellenar el conjunto de datos en el controlador de evento Form1_Load.

Para cargar datos en un conjunto de datos

En el Explorador de soluciones, seleccione Form1 y haga clic en el botón Ver código.

Inspeccione el controlador de evento Form1_Load. El método Fill de TableAdapter rellena con datos el conjunto de datos.

Private Sub Form1_Load() Handles MyBase.Load

    'TODO: This line of code loads data into the 'NorthwindDataSet1.Customers' table. 
    'You can move, or remove it, as needed. 

    Me.CustomersTableAdapter1.Fill(Me.NorthwindDataSet1.Customers)
End Sub

private void Form1_Load(object sender, EventArgs e)
{
    // TODO: This line of code loads data into the 'northwindDataSet1.Customers' table. 
    // You can move, or remove it, as needed. 

    this.customersTableAdapter1.Fill(this.northwindDataSet1.Customers);
}

También puede copiar este código a otras partes de la aplicación donde necesite rellenar el conjunto de datos.

Ejecutar la aplicación

Para ejecutar la aplicación

Presione F5 para ejecutar la aplicación.
El conjunto de datos se rellena con los datos y se muestra en la DataGridView.

Pasos siguientes

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

Agregar funcionalidad de búsqueda al formulario. Para obtener más información, vea Cómo: Agregar una consulta parametrizada a una aplicación de Windows Forms.
Agregar funcionalidad para devolver actualizaciones a la base de datos. Para obtener más información, vea Tutorial: Guardar datos en una base de datos (Tabla única).
Agregar la tabla Orders al conjunto de datos seleccionando Configurar DataSet con el asistente desde la ventana Orígenes de datos. Ahora, agregue controles que muestren los datos relacionados arrastrando el nodo Orders (situado debajo de la columna Fax dentro de la tabla Customers) hasta el formulario. Para obtener más información, vea Cómo: Mostrar datos relacionados en una aplicación de Windows Forms.