Tutorial: Crear un objeto TableAdapter con varias consultas

Artículo
06/10/2015

En este tutorial creará un TableAdapter en un conjunto de datos mediante el Asistente para la configuración de orígenes de datos. Este tutorial le guiará por el proceso de creación de una segunda consulta en el TableAdapter por medio del Asistente para la configuración de consultas de TableAdapter en el Diseñador de DataSet.

Las tareas ilustradas en este tutorial incluyen:

Crear un nuevo proyecto Aplicación Windows.
Crear y configurar un origen de datos en la aplicación creando un conjunto de datos con el Asistente para la configuración de orígenes de datos.
Abrir el nuevo conjunto de datos 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 consiste en crear una aplicación Windows.

Para crear un proyecto de aplicación para Windows nuevo

En el menú Archivo de Visual Studio, cree un 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 el nombre TutorialConsultasTableAdapter al proyecto y 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 la 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.
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.

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.

NorthwindDataset se abre en el Diseñador de DataSet.

Agregar una segunda consulta a CustomersTableAdapter

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

Para agregar una segunda consulta a CustomersTableAdapter

Arrastre una Consulta desde la pestaña DataSet del Cuadro de herramientas a la tabla Customers.

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

Si está usando 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 el nombre FillByCity al método Rellenar un DataTable.

Nota

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

La consulta FillByCity se agrega a CustomersTableAdapter.

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

Para ejecutar la consulta

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

Reemplace el código del controlador de eventos Form1_Load por 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 rellena con los clientes que tengan el valor Seattle en City.

Pasos siguientes

Para agregar funcionalidad a la aplicación

Agregue un control TextBox y un control Button y pase el valor del cuadro de texto a la consulta. (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

Compartir a través de