AGREGAR FILTRADO

A menudo deseará que en la página sólo se muestren datos seleccionados. En esta parte del tutorial modificará la consulta para el control SqlDataSource de manera que los usuarios puedan seleccionar registros de clientes de una ciudad determinada.

En primer lugar, utilizará un control TextBox para crear un cuadro de texto en el que los usuarios puedan escribir el nombre de una ciudad. A continuación, cambiará la consulta para incluir un filtro parametrizado (cláusula WHERE). Como parte de ese proceso, creará un elemento de parámetro para el control SqlDataSource. El elemento de parámetro establece cómo obtendrá el control SqlDataSource el valor para su consulta parametrizada; concretamente, del cuadro de texto.

Cuando finalice esta parte del tutorial, la página podría tener una apariencia similar a la siguiente en la vista Diseño.

Para agregar el cuadro de texto que permite especificar una ciudad

1. Desde el grupo Estándar del Cuadro de herramientas, arrastre a la página un control TextBox y un control Button.
   El control Button sólo se utiliza para devolver la página al servidor. En este caso no tendrá que escribir código.
2. En Propiedades, para el control TextBox, establezca ID en textCity.
3. Si lo desea, escriba Ciudad o un texto similar delante del cuadro de texto, como título.
4. En Propiedades para el control Button, establezca Text en Enviar.

Ahora puede modificar la consulta para que incluya un filtro.

Para modificar la consulta con un filtro parametrizado

1. Haga clic con el botón secundario del mouse en el control SqlDataSource y, a continuación, seleccione Mostrar etiqueta inteligente.
2. En el menú Tareas de SqlDataSource, haga clic en Configurar origen de datos.
   Aparecerá el asistente Configurar origen de datos - <nombreDelOrigenDeDatos>.
3. Haga clic en Siguiente.
   El asistente muestra el comando SQL configurado actualmente para el control SqlDataSource.
4. Haga clic en WHERE.
   Aparecerá la página Agregar cláusula WHERE.
5. En la lista Columna, haga clic en Ciudad.
6. En la lista Operador, haga clic en =.
7. En la lista Origen, haga clic en Control.
8. En Propiedades del parámetro, en la lista Id. de control, haga clic en textCity.
   
   En los cinco pasos anteriores se especifica que con la consulta se obtendrá el valor de búsqueda de Ciudad del control TextBox que agregó en el procedimiento anterior.
9. Haga clic en Agregar.
   La cláusula WHERE que ha creado aparece en un cuadro en la parte inferior de la página.
10. Haga clic en Aceptar para cerrar la página Agregar cláusula WHERE.
11. En el asistente Configurar origen de datos - <nombreDelOrigenDeDatos>, haga clic en Siguiente.
12. En la página Consulta de prueba, haga clic en Consulta de prueba.
    Aparece el asistente, con la página Editor de valores del parámetro, en la que se solicita un valor para utilizarlo en la cláusula WHERE.
13. En el cuadro Valor, escriba Londres y, a continuación, haga clic en Aceptar.
    Aparecen los registros de los clientes de Londres.
14. Haga clic en Finalizar para cerrar el asistente.