Tutorial: Crear un objeto TableAdapter con varias consultas

Actualización: noviembre 2007

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.

Para poder completar este tutorial, necesitará:

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

Para crear un proyecto de aplicación para Windows nuevo

  1. En Visual Studio, en el menú Archivo, cree un nuevo proyecto.

  2. Elija un lenguaje de programación en el panel Tipos de proyecto.

  3. Haga clic en Aplicación para Windows en el panel Plantillas.

  4. 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.

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

  1. En el menú Datos, haga clic en Mostrar orígenes de datos.

  2. 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.

  3. Seleccione Base de datos en la página Elegir un tipo de origen de datos y haga clic en Siguiente.

  4. 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).

  5. Si su base de datos requiere una contraseña, seleccione la opción para incluir datos confidenciales y haga clic en Siguiente.

  6. Haga clic en Siguiente en la página Guardar la cadena de conexión en el archivo de configuración de la aplicación.

  7. Expanda el nodo Tablas en la página Elegir los objetos de base de datos.

  8. 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.

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

  1. Haga clic con el botón secundario en NorthwindDataset en la ventana Orígenes de datos.

  2. En el menú contextual, elija Editar DataSet con el Diseñador.

    Se abre NorthwindDataset en el Diseñador de Dataset.

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

  1. 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.

  2. Seleccione Usar instrucciones SQL y, a continuación, haga clic en Siguiente.

  3. Seleccione SELECT que devuelve filas y haga clic en Siguiente.

  4. 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
    
    ms171907.alert_note(es-es,VS.90).gifNota:

    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 = ?)

  5. En la página Elija los métodos que se van a generar, asigne al método Rellenar un DataTable el nombre FillByCity.

    ms171907.alert_note(es-es,VS.90).gifNota:

    El método para Devolver un DataTable no se utiliza en este tutorial, por lo que se puede desactivar la casilla de verificación o dejar el nombre predeterminado.

  6. Haga clic en Siguiente y finalice el asistente.

    La consulta FillByCity se agrega a CustomersTableAdapter.

Para ejecutar la consulta

  1. En el Explorador de soluciones, seleccione Form1 y haga clic en el Diseñador de vistas.

  2. Arrastre el nodo Customers desde la ventana Orígenes de datos hasta Form1.

  3. Cambie a la vista de código seleccionando Código en el menú Ver.

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

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

Para ejecutar la aplicación

  • Presione F5.

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

Para agregar funcionalidad a su aplicación

Adiciones de comunidad

Mostrar: