Tutorial: Leer y configurar parámetros discretos
Introducción
Un parámetro discreto es un único valor, a diferencia de un parámetro de rango, que hace referencia a un rango de valores. A los elementos de texto (como ciudades) se tiene acceso normalmente mediante parámetros discretos. A los elementos numéricos(como sueldos de empleados) se suele acceder mediante parámetros de rango.
En este tutorial establecerá un valor de un parámetro discreto para ver un informe de clientes basado en un solo campo. El informe muestra únicamente los clientes que viven en las ciudades seleccionadas en una lista de ciudades. La lista de ciudades proviene de los valores predeterminados del parámetro de ciudad. Dichos valores predeterminados del parámetro de ciudad se encapsulan dentro del informe.
Para empezar, va a crear un informe de clientes con un parámetro de ciudad. Los datos del informe proceden de la base de datos de muestra incluida en Crystal Reports para Visual Studio. Al crear una instancia del informe en el código, generará un ArrayList que contiene nombres de ciudades (Paris, Tokyo) y pasará dicha instancia de ArrayList a un método auxiliar que establezca estos nombres como valores actuales del parámetro Ciudad. A continuación, enlazará el informe al control CrystalReportViewer y verá el informe que mostrará únicamente los clientes que vivan en París y Tokio.
En la siguiente parte del tutorial, realizará las siguientes acciones:
- Crear un método que obtenga todos los valores predeterminados y los devuelva en un ArrayList.
- Agregar un control ListBox al formulario y rellenarlo a partir de ArrayList.
- Agregar un control Button para volver a mostrar el informe basado en las selecciones de ListBox.
En la parte final del tutorial, codificará el evento de clic de botón para obtener los elementos seleccionados en el control ListBox y establecerlos para que sean los valores actuales del parámetro de ciudad. El informe se volverá a mostrar incluyendo únicamente los clientes que vivan en las ciudades seleccionadas en el control ListBox.
Este tutorial también se puede realizar con clases del modelo de objetos CrystalReportViewer, aunque se prefiere el modelo de objetos ReportDocument. Para obtener más información sobre el modelo de objetos que se debe utilizar, vea ¿Cuál es el modelo de objetos que se debe utilizar?.
Para seguir los pasos de este tutorial con el modelo de objetos CrystalReportViewer, vea Tutorial: Conectar con una base de datos segura de SQL Server utilizando autenticación de SQL.
Código de ejemplo
Este tutorial incluye código de ejemplo de C# y Visual Basic que muestra la versión finalizada del proyecto. Siga las instrucciones de este tutorial para crear un nuevo proyecto o para abrir el proyecto de código de ejemplo y trabajar con una versión finalizada.
El código de ejemplo se almacena en carpetas que están clasificadas por idioma y tipo de proyecto. Los nombres de las carpetas de cada versión del código de ejemplo son los siguientes:
- Sitio Web en C#: CS_Web_RDObjMod_Parameters
- Proyecto para Windows en C#: CS_Win_RDObjMod_Parameters
- Sitio Web en Visual Basic: VB_Web_RDObjMod_Parameters
- Proyecto para Windows en Visual Basic: VB_Win_RDObjMod_Parameters
Para localizar las carpetas que contienen estos ejemplos, vea Directorio del código de ejemplo de los tutoriales.