Configurazione e utilizzo della barra degli strumenti di ReportViewer

Per configurare il controllo e la barra degli strumenti di ReportViewer, è possibile impostare le proprietà nella finestra Proprietà o nel codice. In particolare è possibile rimuovere o disattivare comandi specifici, nonché impostare i valori utilizzati per l'inizializzazione della barra degli strumenti. Per ulteriori informazioni sulle proprietà del controllo del server Web ReportViewer, vedere Proprietà di Microsoft.Reporting.WebForms.ReportViewer. Per ulteriori informazioni sulle proprietà del controllo Windows Form, vedere Proprietà di Microsoft.Reporting.WinForms.ReportViewer.

Barra degli strumenti di ReportViewer

Il controllo ReportViewer include una barra degli strumenti per le funzionalità di spostamento, ricerca, esportazione e stampa che consentono di operare sui report in un'applicazione distribuita. È possibile impostare le proprietà della barra degli strumenti in fase di progettazione per controllarne l'aspetto e definire la disponibilità delle opzioni di run-time. Per una diversa implementazione della barra degli strumenti è possibile creare una barra degli strumenti personalizzata in sostituzione di quella predefinita.

Nota
A causa delle diverse modalità di rendering degli elementi dell'interfaccia utente in formato HTML e GDI (Graphics Design Instrumentation), è possibile che la barra degli strumenti del report risulti leggermente diversa a seconda che venga utilizzato il controllo del server Web o il controllo di Windows Form.

Mappe documento

La barra degli strumenti di ReportViewer include un'icona utilizzata per attivare/disattivare una mappa documento in un report. Per mappa documento si intende un'area di spostamento, disponibile sul lato sinistro dell'area di visualizzazione del report, che contiene un elenco di collegamenti selezionabili dall'utente per spostarsi in un'area specifica del report. La mappa documento non è disponibile in tutti i report. È infatti necessario impostarne una nella definizione del report se si desidera utilizzare questa funzionalità. Per ulteriori informazioni sulle mappe documento e sulle altre funzionalità interattive relative ai report, vedere Aggiunta delle funzionalità di interattività, visibilità e spostamento a un report (Progettazione report di Visual Studio).

Spostamenti in un report

La barra degli strumenti di ReportViewer include numerose funzioni per lo spostamento tra le pagine. È possibile selezionare una pagina specifica oppure spostarsi direttamente alla prima o all'ultima pagina. Le pagine sono determinate dalle interruzioni di pagina impostate in modo esplicito nella definizione del report. Le interruzioni di pagina possono inoltre essere calcolate automaticamente a seconda del formato di output in uso per il report. Per ulteriori informazioni, vedere Definizione delle dimensioni di pagina e delle interruzioni di pagina in un report (Progettazione report di Visual Studio).

Durante gli spostamenti in report HTML a più pagine è possibile utilizzare il pulsante Indietro del browser. In alternativa, se non si intende utilizzare la barra degli strumenti del browser nell'applicazione, è possibile scegliere il pulsante Indietro della barra degli strumenti di ReportViewer. Si noti che lo stato predefinito del pulsante Indietro della barra degli strumenti di ReportViewer è disattivato. Se si desidera utilizzare questo pulsante, attivare la proprietà ShowBackButton nel controllo ReportViewer.

Per spostarsi in report drill-through, è possibile utilizzare il comando Torna al report padre della barra degli strumenti di ReportViewer, il pulsante Indietro del browser o il pulsante Indietro della barra degli strumenti di ReportViewer. Durante la visualizzazione di report drill-through nel controllo del server Web ReportViewer è consigliabile utilizzare sempre un solo tipo di pulsante Indietro. Se si utilizza una combinazione di pulsanti Indietro nella stessa sessione del report, è possibile che il report drill-through in cui si tenta di spostarsi non sia più attivo nella sessione. In tal caso, verrà visualizzato un messaggio di errore. Per ovviare a questo problema, è sufficiente utilizzare il comando Torna al report padre.

Interruzione e aggiornamento di un report

È possibile utilizzare i pulsanti Aggiorna e Interrompi per attivare o interrompere il rendering del report. Se si sceglie Aggiorna per un report del server elaborato in modalità remota, il server rielaborerà il report in base ai dati più recenti. Si noti che le opzioni di esecuzione configurate nel report determinano se i dati verranno effettivamente aggiornati o recuperati dalla cache. Il controllo non verifica le proprietà del report del server, pertanto è necessario chiedere all'amministratore del server del report se il report è configurato per l'utilizzo di dati in tempo reale.

Il funzionamento delle operazioni di aggiornamento è diverso per la modalità di elaborazione locale. Poiché per i report elaborati in locale vengono utilizzati i dati forniti dall'applicazione, si presuppone che sia il codice dell'applicazione a gestire le operazioni di aggiornamento. Per utilizzare il pulsante Aggiorna della barra degli strumenti, è necessario fornire il codice per la gestione dell'evento Refresh. Se questo evento non viene gestito, la selezione del pulsante Aggiorna non ha alcun effetto. Per ulteriori informazioni sull'evento Refresh per il controllo del server Web, vedere Refresh. Per ulteriori informazioni sulla versione del controllo di Windows Form, vedere Refresh.

Stampa di un report

La barra degli strumenti di ReportViewer include il supporto per la stampa. Tale supporto viene implementato in modo diverso a seconda della versione del controllo e della modalità di elaborazione utilizzata. Sebbene non sia possibile personalizzare o configurare la funzionalità di stampa, è necessario attivare il supporto della stampa nel server del report per i report eseguiti nel controllo del server Web ReportViewer. Per ulteriori informazioni, vedere Stampa di report da ReportViewer.

Utilizzo dello zoom nella pagina del report

La barra degli strumenti di ReportViewer include la funzionalità di zoom standard per ingrandire e ridurre la visualizzazione del report.

Ricerche in un report

La barra degli strumenti di ReportViewer include un campo per la ricerca di testo specifico all'interno di un report. Per eseguire la ricerca di contenuto nel report, digitare una parola o una frase che si desidera trovare. La ricerca viene eseguita senza distinzione tra maiuscole e minuscole a partire dalla pagina o dalla sezione attualmente selezionata. Negli operatori di ricerca non sono supportati i caratteri jolly o i valori booleani. In un'operazione di ricerca viene incluso solo il contenuto visibile. Se il report prevede la funzionalità per nascondere/visualizzare il contenuto, il contenuto nascosto non verrà incluso nelle operazioni di ricerca. Per cercare le occorrenze successive dello stesso valore, fare clic su Avanti.

Esportazione di un report

La barra degli strumenti di ReportViewer include formati di esportazione per il salvataggio del report in un file di applicazione Excel o PDF. Se si utilizza il controllo del server Web, è possibile impostare la proprietà ExportContentDisposition sul controllo in modo da visualizzare immediatamente il report esportato in Excel o in un visualizzatore di file PDF anziché salvarlo in un file.

L'aspetto e le funzionalità del report possono variare a seconda del formato di rendering selezionato. I report che contengono collegamenti, mappe documento e segnalibri potrebbero non funzionare correttamente dopo il salvataggio in un file. A seconda dell'allineamento degli elementi in un report, è possibile che il layout del report in un formato di file diverso includa pagine o spazi vuoti aggiuntivi rispetto a quelli previsti.

Vedere anche

Concetti

Stampa di report da ReportViewer
Controlli del server Web e Windows Form di ReportViewer
Configurazione di ReportViewer per l'elaborazione locale
Configurazione di ReportViewer per l'elaborazione remota