Cómo: Crear consultas parametrizadas de TableAdapter

Artículo
08/10/2011

Una consulta parametrizada devuelve datos que cumplen con las condiciones de una cláusula WHERE dentro de la consulta. Por ejemplo, se pueden agregar parámetros a una lista de clientes para que muestre sólo los clientes de cierta ciudad agregando WHERE City = @City al final de la instrucción SQL que devuelve una lista de clientes. Para obtener más información, vea Consultas de parámetro.

Cree consultas de TableAdapter parametrizadas en el Diseñador de Dataset o durante la creación de formularios enlazados a datos en una aplicación para Windows con el comando Agregar parámetros a origen de datos del menú Datos. El comando Agregar parámetros a origen de datos también crea controles en el formulario para ingresar los valores de parámetro y ejecutar la consulta. Para obtener más información, vea Generador de criterios de búsqueda (cuadro de diálogo).

Nota

Al crear una consulta parametrizada, utilice la notación de parámetro concreto para la base de datos contra la que está codificando. Por ejemplo, los orígenes de datos de Access y OleDb utilizan el signo de interrogación '?' para denotar los parámetros, por lo que la cláusula WHERE tendría esta apariencia: WHERE City = ?.

Nota

Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos. Para cambiar la configuración, elija la opción Importar y exportar configuraciones del menú Herramientas. Para obtener más información, vea Trabajar con valores de configuración.

Crear una consulta de TableAdapter parametrizada

Para crear una consulta parametrizada en el Diseñador de DataSet

Cree un nuevo TableAdapter, agregando una cláusula WHERE con los parámetros deseados a la instrucción SQL. Para obtener más información, vea Cómo: Crear TableAdapters.

O bien
Agregue una consulta a un TableAdapter existente, agregando una cláusula WHERE con los parámetros deseados a la instrucción SQL. Para obtener más información, vea Cómo: Crear consultas de TableAdapter.

Para crear una consulta parametrizada mientras se diseña un formulario enlazado a datos

Seleccione un control en el formulario que ya esté enlazado a un conjunto de datos. Para obtener más información, vea Enlazar controles de Windows Forms a datos en Visual Studio.
En el menú Datos, haga clic en Agregar consulta.
Finalice el cuadro de diálogo Generador de criterios de búsqueda, agregando una cláusula WHERE con los parámetros deseados a la instrucción SQL. Para obtener más información, vea Generador de criterios de búsqueda (cuadro de diálogo).