Tutorial: Rellenar un conjunto de datos con datos

Artículo
10/07/2008

Actualización: noviembre 2007

Este tutorial crea un conjunto de datos con una tabla de datos y lo rellena con datos de la tabla Customers en la base de datos de ejemplo Northwind. El conjunto de datos se llena con datos llamando 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 un objeto DataGridView enlazado a datos arrastrando desde la ventana Orígenes de datos al 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.
Dé al proyecto el nombre DatasetWalkthrough.
Seleccione Aplicación para Windows y haga clic en Aceptar. Para obtener más información, vea Crear aplicaciones basadas en Windows.

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

Crear el NorthwindDataSet

En este paso se crea un conjunto de datos utilizando el Asistente para la 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 la configuración de orígenes de datos.
Seleccione Base de datos en la página Elegir un tipo de origen 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 abrir 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).
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 Tablas en la página Elegir 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 al formulario de la aplicación para Windows.

Para crear un enlace de DataGridView 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 desplazarse en los registros. En la bandeja de componentes aparecen NorthwindDataSet, CustomersTableAdapter, BindingSource y BindingNavigator.

Inspeccionar el código generado que llena el conjunto de datos con 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 eventos 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 eventos Form1_Load. El método Fill del TableAdapter llena el conjunto de datos con datos.

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) 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);
}

Puede copiar este código en otras partes de su 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 datos y se muestra en DataGridView.

Pasos siguientes

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

Agregar funcionalidad de búsqueda al formulario. Para obtener más información, vea Cómo: Agregar una consulta parametrizada a un formulario en una aplicación para Windows.
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 para Windows.