Cómo: Crear consultas parametrizadas de TableAdapter

Artículo
10/07/2008

Actualización: noviembre 2007

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, Access y orígenes de datos de OLEDB utilizan el signo de interrogación '?' para denotar los parámetros, por lo tanto, la cláusula WHERE tendría este aspecto: 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 Valores de configuración de Visual Studio.

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 Información general sobre la presentación de datos.
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).