Share via


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

Para agregar funcionalidad de búsqueda a un formulario en una aplicación de Windows se puede ejecutar una consulta parametrizada. Una consulta parametrizada devuelve datos que cumplen las condiciones de una cláusula WHERE. Para agregar parametrización a una consulta, hay que completar el Generador de criterios de búsqueda (cuadro de diálogo). Por ejemplo, puede parametrizar una consulta para mostrar solo los clientes de una determinada ciudad; para ello, agrega WHERE City = @City al final de la instrucción SQL que devuelve una lista de clientes.

Al completar el cuadro de diálogo Criterios de búsqueda se realiza lo siguiente:

  • Se agrega la consulta al TableAdapter asociado.

  • Se agregan controles al formulario para que los usuarios proporcionen los valores de los parámetros necesarios, y se agrega un botón para ejecutar la consulta.

  • Se agrega código al evento de clic del botón que establece los valores de los parámetros 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 Customizing Development Settings in Visual Studio.

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 en Etiquetas inteligentes de datos.

    Nota

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

  3. Seleccione la tabla a la que quiera agregar 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 usa parámetros en el cuadro Texto de la consulta.

  6. Haga clic en Aceptar.

    Se agregan al formulario un control para especificar los valores del parámetro y un botón Cargar, en un control ToolStrip.

Vea también

Tareas

Tutorial: Crear Windows Forms para buscar datos

Tutorial: Mostrar datos en 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

Crear y editar conjuntos de datos con tipo

Información general sobre orígenes de datos

Validar datos