Cómo: Llenar un conjunto de datos con datos

Artículo
10/07/2008

Actualización: noviembre 2007

La frase "rellenar un conjunto de datos con datos" hace referencia a la carga de datos en los objetos DataTable individuales que constituyen el conjunto de datos. Rellene las tablas de datos ejecutando consultas de TableAdapter o comandos del adaptador de datos (por ejemplo, SqlDataAdapter).

Si debe utilizar TableAdapters o adaptadores de datos depende de cómo haya creado el conjunto de datos. Si utilizó las herramientas de diseño en Visual Studio, tales como Asistente para la configuración de orígenes de datos, el conjunto de datos contendrá TableAdapters. Para obtener más información sobre TableAdapters, vea Información general sobre TableAdapter. Si creó el conjunto de datos mediante programación, necesitará crear adaptadores de datos para cargar datos en las tablas de datos. Para obtener más información, vea Introducción a los adaptadores de datos.

Nota:
Al arrastrar elementos desde Ventana Orígenes de datos a un formulario, el código para rellenar la tabla con datos se agrega automáticamente al controlador del evento Form_Load. Abra el formulario en el editor de código para ver la sintaxis exacta que debe usar para rellenar tablas concretas. Si no desea rellenar la tabla cuando se carga el formulario, puede mover este código a algún otro método o eliminarlo completamente.

Al arrastrar elementos desde Ventana Orígenes de datos a un formulario, el código para rellenar la tabla con datos se agrega automáticamente al controlador del evento Form_Load. Abra el formulario en el editor de código para ver la sintaxis exacta que debe usar para rellenar tablas concretas. Si no desea rellenar la tabla cuando se carga el formulario, puede mover este código a algún otro método o eliminarlo completamente.

Rellenar un conjunto de datos mediante TableAdapter

Puede llamar a una consulta en el objeto TableAdapter para cargar datos en las tablas de datos de un conjunto de datos. Pase el objeto DataTable que desee rellenar a la consulta de TableAdapter. Si la consulta acepta parámetros, páselos también al método. Si el conjunto de datos contiene varias tablas, debe tener objetos TableAdapters separados por tablas y, por consiguiente, debe rellenar cada tabla por separado.

Nota:
De manera predeterminada, cada vez que ejecuta una consulta de TableAdapter, los datos de la tabla se borran antes de que se carguen los resultados de la consulta en la tabla. Puede mantener los datos existentes en la tabla y anexar los resultados estableciendo la propiedad ClearBeforeFill de TableAdapter en false.

Para rellenar un conjunto de datos mediante TableAdapter

Abra el formulario o componente en el Editor de código.
Agregue el código a cualquier parte de la aplicación donde necesite cargar una tabla con datos. Si su consulta no acepta parámetros, pase el objeto DataTable que desea rellenar. El código puede ser similar al siguiente:
```
Me.CustomersTableAdapter.Fill(Me.NorthwindDataSet.Customers)
```
```
this.customersTableAdapter.Fill(this.northwindDataSet.Customers);
```

Si la consulta acepta parámetros, pase el objeto DataTable que desee rellenar y los parámetros esperados por la consulta. Dependiendo de los parámetros reales de su consulta, el código puede parecerse a los siguientes ejemplos:

CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, "Seattle")
CustomersTableAdapter.FillByCityAndState(NorthwindDataSet.Customers, "Seattle", "WA")

customersTableAdapter.FillByCity(northwindDataSet.Customers, "Seattle");
customersTableAdapter.FillByCityAndState(northwindDataSet.Customers, "Seattle", "WA");

Rellenar un conjunto de datos mediante DataAdapter

Llame al método Fill del adaptador de datos. De este modo, el adaptador ejecuta una instrucción SQL o un procedimiento almacenado al que se hace referencia en su propiedad SelectCommand y guarda los resultados en una tabla del conjunto de datos. Si el conjunto de datos contiene varias tablas, debe tener los adaptadores de datos separados por tablas y, por consiguiente, debe rellenar cada tabla por separado.

Para rellenar un conjunto de datos mediante DataAdapter

Llame al método Fill de DataAdapter, y pase el objeto DataSet o DataTable en el que se van a cargar los datos. Por ejemplo:
```
sqlDataAdapter1.Fill(dataset1.Tables("Customers"))
```
```
sqlDataAdapter1.Fill(dataset1.Tables["Customers"]);
```
Normalmente, debe proporcionar el nombre del objeto DataTable en el que se van a cargar los datos. Si pasa el nombre de un DataSet en lugar de una tabla de datos concreta, se agrega un objeto DataTable denominado Table1 al conjunto de datos y se carga con los resultados de la base de datos (a diferencia de que se carguen los datos en un objeto DataTable existente en el conjunto de datos). Para obtener más información, vea Rellenar un objeto DataSet desde un objeto DataAdapter (ADO.NET).