Configurazione e utilizzo della barra degli strumenti di ReportViewer

Articolo
08/31/2012

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 disabilitare 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 navigazione, ricerca, esportazione e stampa che consente agli utenti di utilizzare rapporti 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 in formato HTML e GDI (Graphics Design Instrumentation) degli elementi dell'interfaccia utente, è possibile che la barra degli strumenti del rapporto risulti leggermente diversa a seconda che venga utilizzato il controllo server Web o il controllo Windows Form.

Mappe documento

Una mappa documento è un'area di navigazione che contiene un elenco di collegamenti su cui gli utenti possono fare clic per passare a un'area specifica del rapporto.La mappa documento è una casella di divisione comprimibile disponibile sul lato sinistro dell'area di visualizzazione del rapporto (o sul lato destro in ambienti con lettura da destra a sinistra).Non in tutti i rapporti è disponibile una mappa documento. È infatti necessario impostarne una nella definizione del rapporto se si desidera visualizzarla nel visualizzatore di rapporti.Per ulteriori informazioni sulle mappe documento e sulle altre funzionalità interattive relative ai rapporti, vedere Adding Interactivity and Navigation to a ReportViewer Report.

Spostamenti in un rapporto

La barra degli strumenti di ReportViewer include numerose funzioni per la navigazione tra pagine.L'utente può selezionare una pagina specifica o passare direttamente alla prima pagina o all'ultima.Le pagine sono determinate dalle interruzioni di pagina impostate in modo esplicito nella definizione del rapporto.Le interruzioni di pagina possono inoltre essere calcolate automaticamente a seconda del formato di output in uso per il rapporto.Per ulteriori informazioni, vedere Defining Page Size and Page Breaks in a ReportViewer Report.

Poiché il controllo ReportViewer di ASP.NET utilizza per impostazione predefinita postback asincroni per l'interattività, l'utente non può utilizzare il pulsante Indietro del browser a meno che non si imposti la proprietà InteractivityPostBackMode su AlwaysSynchronous.

Per spostarsi tra rapporti drill-through, l'utente può utilizzare il pulsante Torna al rapporto padre della barra degli strumenti di ReportViewer o il pulsante Indietro del browser se si imposta la proprietà InteractivityPostBackMode di conseguenza.È consigliabile, tuttavia, progettare l'applicazione prevedendo un'opzione di navigazione per mantenere lo stato sessione coerente quando l'utente si sposta tra rapporti drill-through.In caso contrario, durante la spostamento tra rapporti drill-through l'utente potrebbe ricevere un messaggio di errore indicante che la chiamata è senza rapporto drill-through.Per mantenere una sola opzione di navigazione per l'utente, è possibile effettuare le operazioni seguenti:

Utilizzare la modalità AlwaysAsynchronous e impostare ShowBackButton su true.
Utilizzare la modalità AlwaysSynchronous o SynchronousOnDrillthrough e impostare ShowBackButton su false.In questo modo, l'utente è vincolato al solo pulsante Indietro del browser.Si noti che questa opzione non sfrutta le funzionalità AJAX del controllo server Web.

Interruzione e aggiornamento di un rapporto

Nel controllo server Web l'utente può fare clic sul collegamento Annulla nell'indicatore di stato occupato per annullare il rendering del rapporto.Nel controllo Windows Form l'utente può fare clic sul pulsante Interrompi sulla barra degli strumenti di ReportViewer per annullare il rendering del rapporto.L'utente può utilizzare il pulsante Aggiorna per attivare il rendering del rapporto.

Se l'utente fa clic su Aggiorna per un rapporto del server, il server di rapporti rielabora il rapporto con i dati più recenti.Si noti che i dati più recenti sono soggetti ai criteri snapshot e di memorizzazione nella cache impostati nel rapporto.

Se l'utente fa clic su Aggiorna per un rapporto locale, il comportamento può essere diverso.Poiché i rapporti elaborati in locale utilizzano dati forniti dall'applicazione, potrebbe essere necessario aggiornare l'origine dati durante le operazioni di aggiornamento specificando il codice per la gestione dell'evento ReportViewer.ReportRefresh.Se questo evento non viene gestito per il controllo Windows Form, premendo il pulsante Aggiorna il rapporto viene aggiornato con dati non aggiornati nell'applicazione.Per ulteriori informazioni sull'evento ReportViewer.ReportRefresh per il controllo server Web, vedere ReportRefresh.Per ulteriori informazioni sulla versione del controllo Windows Form, vedere ReportRefresh.

Stampa di un rapporto

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 ReportViewer.Il controllo server Web, inoltre, fornisce il supporto per la stampa solo in Internet Explorer.Per ulteriori informazioni, vedere Stampa di rapporti da ReportViewer.

Utilizzo dello zoom nella pagina del rapporto

La barra degli strumenti di ReportViewer include la funzionalità di zoom standard, che consente di ingrandire e ridurre la visualizzazione del rapporto.Il controllo server Web fornisce il supporto per lo zoom solo in Internet Explorer.

Ricerche in un rapporto

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

Esportazione di un rapporto

La barra degli strumenti di ReportViewer fornisce formati di esportazione che consentono all'utente di salvare un rapporto in un formato supportato.È possibile esportare un rapporto locale in un file di Excel, un file PDF o un file di Word.Un rapporto del server può essere esportato in qualsiasi formato supportato dal server di rapporti.Se si utilizza il controllo server Web, è possibile impostare la proprietà ExportContentDisposition sul controllo per visualizzare immediatamente il rapporto esportato in Excel o in un visualizzatore di file PDF anziché salvarlo in un file.

L'aspetto e le funzionalità del rapporto possono variare a seconda del formato di rendering selezionato.I rapporti 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 rapporto, è possibile che il layout del rapporto in un formato di file diverso includa un diverso numero di pagine o spazi vuoti aggiuntivi.Per ulteriori informazioni, vedere Exporting Reports nella documentazione online di SQL Server.