Tutorial: Crear un objeto TableAdapter con varias consultas

Artículo
08/10/2011

En este tutorial, creará un objeto TableAdapter en un conjunto de datos utilizando el Asistente para la configuración de orígenes de datos. El tutorial le guía a lo largo del proceso de crear una segunda consulta en el TableAdapter utilizando el Asistente para la configuración de consultas de TableAdapter dentro del Diseñador de DataSet.

Las tareas ilustradas en este tutorial incluyen:

Crear un proyecto nuevo de Aplicación para Windows.
Crear y configurar un origen de datos en la aplicación generando un conjunto de datos con el Asistente para la configuración de orígenes de datos.
Abrir el conjunto de datos nuevo en el Diseñador de Dataset.
Agregar consultas al TableAdapter con el Asistente para la configuración de consultas de TableAdapter.

Requisitos previos

Para completar las tareas de este tutorial, necesitará:

Acceso a la base de datos de ejemplo Northwind (versión de SQL Server o Access). Para obtener más información, vea Cómo: Instalar bases de datos de ejemplo.

Crear una nueva aplicación para Windows

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

Para crear un proyecto de aplicación para Windows nuevo

En Visual Studio, en el menú Archivo, cree un nuevo proyecto.
Elija un lenguaje de programación en el panel Tipos de proyecto.
Haga clic en Aplicación para Windows en el panel Plantillas.
Asigne al proyecto el nombre TableAdapterQueriesWalkthrough y, a continuación, haga clic en Aceptar.

Visual Studio agrega el proyecto al Explorador de soluciones y muestra un nuevo formulario en el diseñador.

Crear un origen de datos de base de datos con un TableAdapter

En este paso se crea un origen 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 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 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. 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.

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

Abrir el conjunto de datos en el Diseñador de DataSet

Para abrir el conjunto de datos en el Diseñador de DataSet

Haga clic con el botón secundario en NorthwindDataset en la ventana Orígenes de datos.
En el menú contextual, elija Editar DataSet con el Diseñador.

Se abre NorthwindDataset en el Diseñador de Dataset.

Agregar una segunda consulta al CustomersTableAdapter

El asistente creó el conjunto de datos con una tabla de datos Customers y CustomersTableAdapter. En esta sección del tutorial se agrega una segunda consulta a CustomersTableAdapter.

Para agregar una consulta a CustomersTableAdapter

Arrastre una Consulta de la ficha DataSet del Cuadro de herramientas hasta la tabla Customers.

Se abre Asistente para la configuración de consultas de TableAdapter.
Seleccione Usar instrucciones SQL y, a continuación, haga clic en Siguiente.
Seleccione SELECT que devuelve filas y haga clic en Siguiente.
Agregue una cláusula WHERE a la consulta que exprese lo siguiente:
```
SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax 
FROM Customers 
WHERE City = @City
```
Nota

Si utiliza la versión de Access de Northwind, reemplace el parámetro @City por un signo de interrogación. (SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = ?)
En la página Elija los métodos que se van a generar, asigne al método Rellenar un DataTable el nombre FillByCity.

Nota

El método para Devolver un DataTable no se utiliza en este tutorial, por lo que se puede desactivar la casilla o dejar el nombre predeterminado.
Haga clic en Siguiente y finalice el asistente.

La consulta FillByCity se agrega a CustomersTableAdapter.

Agregar código para ejecutar la consulta adicional en el formulario

Para ejecutar la consulta

En el Explorador de soluciones, seleccione Form1 y haga clic en el Diseñador de vistas.
Arrastre el nodo Customers desde la ventana Orígenes de datos hasta Form1.
Cambie a la vista de código seleccionando Código en el menú Ver.

Reemplace el código del controlador de eventos Form1_Load con lo siguiente para ejecutar la consulta FillByCity.

Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)

string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);

Ejecutar la aplicación

Para ejecutar la aplicación

Presione F5.
La cuadrícula se llena de clientes cuyo valor de City es Seattle.

Pasos siguientes

Para agregar funcionalidad a la aplicación

Agregue un control TextBox y un control Button y pase a la consulta el valor contenido en el cuadro de texto. (CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, TextBox1.Text)).
Agregue la lógica de validación al evento ColumnChanging o RowChanging de las tablas de datos en el conjunto de datos. Para obtener más información, vea Validar los datos en conjuntos de datos.

Vea también