Tutorial: Aplicación de consulta parametrizada

Actualización: noviembre 2007

Este tutorial muestra cómo utilizar el entorno Visual Studio para desarrollar una aplicación de consulta parametrizada simple. Tanto el enlace de datos como gran parte de la interfaz de usuario se generan automáticamente. Esta aplicación, basada en la conocida base de datos Northwind, proporciona el escenario donde los usuarios de Smart Device deben especificar el Shipping Country si solamente conocen el Order Number. Las aplicaciones que genere aquí proporcionarán los datos del usuario relacionados con el Order Number y la presentación del Shipping Country correspondiente.

Nota:
Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Valores de configuración de Visual Studio.

Este tutorial se ha escrito usando Configuración de desarrollo de Visual Basic y Configuración de desarrollo de Visual C#.

Requisitos previos

La base de datos Northwind para SQL Server Compact 3.5, incluida en Visual Studio.

Nota:
Si no es un administrador de su equipo de desarrollo, no podrá abrir el archivo Northwind.sdf en su ubicación predeterminada unidad:\Archivos de programa\Microsoft SQL Server Compact Edition\v3.5\Samples. Copie el archivo en el escritorio o en Mis documentos y ábralo desde allí cuando se le solicite.

Elegir un dispositivo de destino

Lleve a cabo el procedimiento siguiente para asegurarse de que se le pedirá seleccionar un dispositivo cuando implemente la solución.

Para solicitar opciones de dispositivos durante la implementación

1. En el menú Herramientas, haga clic en Opciones, expanda Herramientas de dispositivo y, a continuación, haga clic en General.

2. Active la casilla Mostrar dispositivos antes de implementar un proyecto de dispositivo.

Crear la aplicación

Ésta es una aplicación de Windows Forms simple para hospedar la funcionalidad de los datos de este tutorial.

Para crear un proyecto de dispositivos de formularios Windows Forms

1. (Visual Basic) En el menú Archivo de Visual Studio, haga clic en Nuevo proyecto.

   O bien

   (Visual C#) En el menú Archivo de Visual Studio, elija Nuevo y haga clic en Proyecto.

2. En el panel Tipos de proyecto, expanda Visual Basic o Visual C#, haga clic en Smart Device, haga clic en Proyecto de Smart Device en el panel Plantillas, escriba ParamQuerySample en el cuadro Nombre y, a continuación, haga clic en Aceptar.

3. En el cuadro de diálogo Agregar nuevo proyecto de Smart Device, seleccione Pocket PC 2003 en el menú desplegable Plataforma de destino, haga clic en Aplicación de dispositivo y, a continuación, haga clic en Aceptar.

   Aparece una representación de un dispositivo Pocket PC en el Diseñador de Windows Forms.

Agregar la funcionalidad de datos

En esta sección aparecen las siguientes tareas:

• Seleccionar un tipo de origen de datos.

• Seleccionar y configurar una conexión de datos.

• Seleccionar objetos de base de datos.

• Agregar controles con enlace a datos al formulario.

Para seleccionar un tipo de origen de datos

1. En el menú Datos, haga clic en Agregar nuevo origen de datos para abrir el Asistente para la configuración de orígenes de datos.

2. En la página Elegir un tipo de origen de datos, haga clic en Base de datos y luego en Siguiente.

Para seleccionar y configurar una conexión de datos

1. En la página Elegir la conexión de datos, haga clic en Nueva conexión.

2. En el cuadro de diálogo Elegir origen de datos, haga clic en Microsoft SQL Server Compact 3.5 y, a continuación, haga clic en Continuar.

   Nota:
   Dependiendo de la configuración y los proyectos anteriores, el cuadro de diálogo Agregar conexión podría aparecer en lugar del cuadro de diálogo Elegir origen de datos. Si sucede esto, haga clic en Cambiar en el cuadro de diálogo Agregar conexión para abrir el cuadro de diálogo Cambiar origen de datos. A continuación, seleccione Microsoft SQL Server Compact 3.5 y haga clic en Aceptar.

3. En el cuadro de diálogo Agregar conexión, seleccione Mi PC.

4. En el cuadro de diálogo Agregar conexión, haga clic en Examinar.

5. En el cuadro de diálogo Seleccionar archivo de base de datos de SQL Server Compact 3.5, haga clic en Northwind.sdf y, a continuación, haga clic en Abrir.

6. En el cuadro de diálogo Agregar conexión, deje el cuadro Contraseña vacío.

   Esta base de datos no tiene ninguna contraseña.

   Nota de seguridad:
   Utilice una contraseña segura para las bases de datos que se utilicen en aplicaciones reales.

7. Haga clic en Probar conexión para comprobar la conexión.

   Nota:
   Si se le deniega el acceso al archivo Northwind.sdf, copie el archivo en el escritorio y vaya hasta esa copia para abrirla. Esta situación puede producirse si no se cuenta con suficientes derechos en el equipo de desarrollo para abrir el archivo en la ubicación predeterminada, que se describe al inicio de este tutorial.

8. Haga clic en Aceptar en el cuadro de mensaje que muestra la conexión satisfactoria y, a continuación, haga clic en Aceptar para cerrar el cuadro de diálogo Agregar conexión.

9. En la página Elegir la conexión de datos, haga clic en Siguiente.

10. En el cuadro de mensaje que pregunta si el usuario desea copiar el archivo en el correspondiente proyecto, haga clic en Sí.

Para seleccionar objetos de base de datos

1. En la página Elija los objetos de base de datos, expanda Tables y, a continuación, seleccione la tabla Orders.

2. Haga clic en Finalizar.

   Se crea NorthwindDataset. Puede ver este origen de datos si hace clic en Mostrar orígenes de datos en el menú Datos.

Para crear la consulta

1. En la ventana Orígenes de datos, expanda la tabla Orders.

2. Haga clic en la columna País de envío, haga clic en la flecha desplegable y seleccione la opción Etiqueta.

3. Arrastre la columna País de envío al formulario del diseñador.

4. En el control de etiqueta del diseñador, haga clic en la etiqueta inteligente y, a continuación, haga clic en Agregar consulta.

5. En el cuadro de diálogo Generador de criterios de búsqueda, haga clic en Generador de consultas.

6. En la columna Filtro de la fila Id de pedido, escriba un signo de interrogación (?).

   Este símbolo indica que los usuarios de la aplicación tendrán que especificar un valor para Id. de pedido.

7. Haga clic en Aceptar.

   La cláusula WHERE del cuadro Texto de la consulta debería aparecer ahora como ([Order ID]=@PARAM1).

8. Haga clic en Aceptar para cerrar el cuadro de diálogo Generador de criterios de búsqueda.

   Aparece un panel en el formulario del diseñador.

Para refinar la interfaz de usuario

1. Haga clic con el botón secundario del mouse en el control de etiqueta PARAM1 del diseñador y, a continuación, haga clic en Propiedades.

   O bien

   Seleccione el control Param1Label en la ventana Propiedades.

2. Cambie la propiedad Texto a Id de pedido.

3. Seleccione el botón Rellenar por y, a continuación, cambie su propiedad de texto a Mostrar país.

4. Expanda el panel y los controles para eliminar las barras de desplazamiento y mostrar todo el texto. Hay que tener especial cuidado con que Ship_CountryLabel y su cuadro de texto no se ocultan detrás de FillByPanel y sus pertinentes controles.

Probar la aplicación

En esta sección se genera la aplicación, descárguela en el emulador SE de Pocket PC 2003 y compruebe que la aplicación funciona correctamente.

Para probar la aplicación

1. En el menú Depurar, haga clic en Inicio o Iniciar depuración.

2. En el cuadro de diálogo Implementar, seleccione Emulador SE de Pocket PC 2000 y haga clic en Implementar.

   El progreso de la implementación aparece en la barra Estado. La implementación en el emulador puede tardar algún tiempo.

3. Cuando la aplicación se ejecute en el emulador, escriba un número de pedido, comprendido entre 10000 y 11077 en la base de datos Northwind, y, a continuación, haga clic en Mostrar país.

   El Ship Country para ese pedido aparece en el control de etiqueta.

Prepararse para tutoriales adicionales

Si piensa seguir otros tutoriales o abrir otros proyectos, le resultará conveniente cerrar el emulador y salir de esta solución.

Para cerrar el emulador y la solución

1. En el menú Archivo del emulador, haga clic en Salir.

2. En el cuadro de mensaje Emulador de dispositivos, haga clic en No en el mensaje que pregunta si desea guardar el estado del emulador.

3. (Visual Basic) En el menú Archivo, haga clic en Cerrar proyecto.

   — o bien —

   (Visual C#) En el menú Archivo, haga clic en Cerrar solución.

   Si se le solicita que guarde el proyecto o la solución, haga clic en Guardar si desea volver a utilizarlo posteriormente; de no ser así, haga clic en Descartar para que no se guarden los archivos.

Vea también

Tareas

Cómo: Crear consultas parametrizadas (Dispositivos)

Referencia

Asistente para la configuración de orígenes de datos

Datos (Cómo se escriben en Smart Devices)

Otros recursos

Trabajar con datos en proyectos de dispositivos administrados