Cómo: Agregar una consulta parametrizada a una aplicación de Windows Forms

Agregar funcionalidad de búsqueda a un formulario de una aplicación para Windows puede lograrse mediante la ejecución de una consulta parametrizada. Una consulta parametrizada devuelve los datos que cumplen con las condiciones de una cláusula WHERE. Se agrega parametrización a una consulta mediante la finalización del Generador de criterios de búsqueda (cuadro de diálogo). Por ejemplo, puede agregar parámetros para que una consulta muestre sólo los clientes de cierta ciudad si se agrega 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.

Al finalizar el cuadro de diálogo Área de búsqueda, ocurre lo siguiente:

  • La consulta se agrega al TableAdapter asociado.

  • Los controles se agregan al formulario para que los usuarios proporcionen cualquier valor de parámetro necesario y se agrega un botón para ejecutar la consulta.

  • Se agrega un código al evento clic de botón que establece los valores de parámetro y ejecuta la consulta.

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.

Para agregar una consulta a un formulario enlazado a datos existente

  1. Abra el formulario en el Diseñador de Windows Forms.

  2. Haga clic en Agregar consulta en el menú Datos o Etiquetas inteligentes de datos.

    Nota

    Si Agregar consulta no está disponible en el menú Datos, seleccione un control en el formulario que muestre el origen de datos al que desea agregar la parametrización. Por ejemplo, si el formulario muestra los datos en un control DataGridView, selecciónelo. Si el formulario muestra los datos en controles individuales, seleccione cualquier control enlazado a datos.

  3. Seleccione la tabla deseada para agregar la parametrización en el área Seleccionar tabla de origen de datos. Para obtener más información, vea Generador de criterios de búsqueda (cuadro de diálogo).

  4. Escriba un nombre en el cuadro Nuevo nombre de consulta si va a crear una nueva consulta.

    O bien

    Seleccione una consulta en el cuadro Nombre de consulta existente.

  5. Escriba una consulta que acepte parámetros en el cuadro Texto de la consulta.

    SugerenciaSugerencia

    Utilice el Generador de consultas para ayudar a crear una consulta. Para obtener más información, vea Herramientas de diseño de consultas y vistas.

  6. Haga clic en Aceptar.

    Se agregan un control para la entrada del parámetro y un botón Cargar al formulario de un control ToolStrip.

Vea también

Tareas

Tutorial: Crear un formulario Windows Forms para buscar datos

Tutorial: Mostrar datos en un formulario Windows Forms

Cómo: Conectarse a los datos de una base de datos

Cómo: Explorar datos con el control BindingNavigator de formularios Windows Forms

Cómo: Ordenar y filtrar datos ADO.NET con el componente BindingSource de formularios Windows Forms

Cómo: Crear una tabla de búsqueda con el componente BindingSource de formularios Windows Forms

Referencia

Orígenes de datos (ventana)

Conceptos

Información general sobre TableAdapter

Diseñador de DataSet

Información general sobre orígenes de datos

Otros recursos

Validar datos