Collegamento del report

Durante l'esecuzione delle istruzioni fornite in Configurazione di un progetto come preparazione a questa esercitazione, è stato inserito un controllo CrystalReportViewer nel Web Form o nel Windows Form. Nei passaggi precedenti, il report CustomersByCity è stato aggiunto al progetto.

In questa sezione, il percorso della directory di file del report CustomersByCity viene collegato al controllo CrystalReportViewer. Viene quindi verificato se è possibile visualizzare correttamente il report quando i valori correnti del campo parametro non sono ancora stati impostati.

Per collegare il percorso della directory di file del report CustomersByCity al controllo CrystalReportViewer

1. Aprire il Web Form o il Windows Form.

2. Dal menu Visualizza, scegliere Codice per visualizzare la classe di codice sottostante relativa al Web Form o al Windows Form.

3. Individuare il metodo ConfigureCrystalReports() creato in Configurazione di un progetto.

4. Dichiarare una variabile di stringa, denominarla reportPath e assegnarle un percorso della fase di esecuzione del report locale. Questo percorso viene determinato in modo diverso a seconda che si tratti di siti Web o di progetti Windows:

   • In un sito Web, trasferire il nome del file di report locale come parametro stringa nel metodo Server.MapPath(). In questo modo, in fase di esecuzione viene eseguita la mappatura del report locale al percorso della directory di file del disco rigido.

     Dim reportPath As String = Server.MapPath("CustomersByCity.rpt")
     

     string reportPath = Server.MapPath("CustomersByCity.rpt");
     

   • In un progetto Windows, concatenare la proprietà Application.StartupPath con una barra rovesciata e il nome del file di report locale. In questo modo viene eseguita la mappatura del report nella stessa directory dell'eseguibile Windows.

     Nota
     Al momento della compilazione, copiare il report nella directory contenente il file eseguibile.

     Dim reportPath As String = Application.StartupPath & "\" & "CustomersByCity.rpt"
     

     string reportPath = Application.StartupPath + "\\" + "CustomersByCity.rpt";
     

5. Assegnare il percorso della directory di file del report CustomersByCity alla proprietà ReportSource del controllo CrystalReportViewer.

   myCrystalReportViewer.ReportSource = reportPath
   

   crystalReportViewer.ReportSource = reportPath;
   

Per verificare il caricamento del report CustomersByCity

A questo punto è possibile creare ed eseguire il progetto. È previsto che il caricamento del report abbia esito negativo, poiché il codice per l'impostazione di un valore per campo parametro Città non è stato ancora scritto.

1. Dal menu Genera, scegliere Genera soluzione.

2. Se si verificano errori di generazione, correggerli.

3. Se si utilizza un report non incorporato in un progetto Windows, individuare l'eseguibile Windows compilato nella sottodirectory \bin\ [Visual Basic] o \bin\debug\ [C#] e copiarvi il report.

<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<thead>
<tr class="header">
<th><img src="images\Aa983431.alert_note(it-it,VS.90).gif" alt="Note" class="note" />Nota</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><p>Affinché il report non incorporato venga caricato dall'eseguibile Windows in fase di esecuzione, è necessario salvare il report nella stessa directory dell'eseguibile.</p></td>
</tr>
</tbody>
</table>

4. Dal menu Debug, scegliere Avvia.

   Il report CustomersByCity non verrà visualizzato. Per visualizzarlo, è necessario aggiungere un valore per il campo parametro Città, più avanti nel corso di questa esercitazione.

   Nota

   I risultati possono variare, in base alla versione di Crystal Reports in uso. Nelle versioni più recenti, viene visualizzato un form in cui si richiede di inserire i valori per il parametro del report. In quelle precedenti, invece, viene generata l'eccezione "Valore corrente del campo parametro mancante". In entrambi i casi, per creare un'applicazione completamente funzionale è necessario aggiungere codice supplementare.

5. Tornare a Visual Studio e fare clic su Interrompi per uscire dalla modalità di debug.