Esercitazione: Lettura e impostazione di parametri discreti
Introduzione
Un parametro discreto è un valore singolo, al contrario di un parametro di intervallo che si riferisce a un intervallo di valori. Agli elementi di testo (come le città) si accede in genere tramite parametri discreti. Agli elementi numerici (come gli stipendi dei dipendenti) si accede in genere tramite parametri di intervallo.
In questa esercitazione viene impostato un valore per un parametro discreto che consente di visualizzare un report clienti basato su un campo. Il report mostra solo i clienti che vivono nelle città selezionate da un apposito elenco. L’elenco delle città deriva dai valori predefiniti del parametro Città. Tali valori predefiniti sono incapsulati all'interno nel report.
Iniziare creando un report clienti con un parametro Città. I dati del report sono derivati dal database di esempio fornito con Crystal Reports per Visual Studio. Quando si crea un’istanza del report nel codice, si crea un ArrayList contenente nomi di città (Paris, Tokyo) e si passa l’istanza ArrayList a un metodo di supporto che imposta tali nomi come i valori correnti del parametro Città. A questo punto, collegare il report al controllo CrystalReportViewer e visualizzare il report mostrando solo i clienti che vivono a Parigi e Tokyo.
Nella parte successiva dell'esercitazione vengono effettuate le seguenti operazioni:
- Creazione di un metodo che recupera tutti i valori predefiniti e li restituisce in un ArrayList.
- Aggiunta di un controllo ListBox al form e compilazione dello stesso dall’ArrayList.
- Aggiunta di un controllo Button per rivisualizzare il report in base alle selezioni nel controllo ListBox.
Nella parte finale dell’esercitazione, viene codificato l’evento clic del controllo Button per recuperare tutti gli elementi selezionati nel controllo ListBox, quindi tali valori vengono impostati come valori correnti del parametro Città. Il report viene nuovamente visualizzato mostrando solo i clienti che vivono nelle città selezionate nel controllo ListBox.
Codice di esempio
Ciascuna esercitazione viene fornita con un codice di esempio in linguaggio Visual Basic e C# che illustra la versione completa del progetto. Seguire le istruzioni riportate in questa esercitazione per creare un nuovo progetto o aprire il progetto del codice di esempio per utilizzare una versione completa.
Il codice di esempio si trova in cartelle classificate per lingua e tipo di progetto. I nomi delle cartelle per ciascuna versione di codice di esempio sono i seguenti:
- Sito Web in C#: CS_Web_CRVObjMod_Parameters
- Progetto Windows C#: CS_Win_CRVObjMod_Parameters
- Sito Web in Visual Basic: VB_Web_CRVObjMod_Parameters
- Progetto Windows Visual Basic: VB_Win_CRVObjMod_Parameters
Per individuare le cartelle contenenti questi esempi, vedere Directory del codice di esempio delle esercitazioni.