Aggiunta e configurazione dei controlli ReportViewer

Articolo
05/09/2011

È possibile aggiungere una o più istanze di un controllo ReportViewer a un'applicazione Windows Form o ASP.NET trascinando il controllo dalla sezione Rapporto della casella degli strumenti a una pagina o un form dell'applicazione. È possibile utilizzare un pannello smart tag e le relative proprietà per configurare il controllo e associare il rapporto. È anche possibile scrivere il codice se si desidera configurare il controllo a livello di programmazione.

Il controllo ReportViewer consente di visualizzare un rapporto alla volta. Per visualizzare i rapporti contemporaneamente, è possibile combinare più istanze del controllo sulla stessa pagina o form. È possibile utilizzare anche una sola istanza del controllo in modo che venga visualizzato un solo rapporto alla volta. Per visualizzare una sequenza di rapporti mediante un singolo controllo, è necessario scrivere il codice che associa un rapporto all'istanza del controllo ReportViewer da utilizzare.

I controlli ReportViewer possono essere utilizzati in modalità di elaborazione locale o remota.

In modalità di elaborazione locale il controllo apre una definizione del rapporto, la elabora e quindi visualizza il rapporto nell'area di visualizzazione. In modalità di elaborazione locale è inoltre possibile ottenere la definizione del rapporto da un file con estensione rdlc del file system, da un flusso o da una risorsa incorporata nell'applicazione. Per ulteriori informazioni, vedere ReportPath, LoadReportDefinition e ReportEmbeddedResource.

In modalità di elaborazione remota, il controllo recupera un rapporto completamente elaborato da un server di rapporti di Reporting Services. In modalità di elaborazione remota tutte le operazioni di elaborazione dei dati e dei rapporti vengono eseguite nel server di rapporti. La modalità di elaborazione remota viene in genere utilizzata per i rapporti pre-pubblicati, ma è anche possibile utilizzala per una definizione del rapporto fornita utilizzando un flusso. Per ulteriori informazioni, vedere LoadReportDefinition, ReportServerUrl e ReportPath.

Importante
In modalità di elaborazione remota non è possibile utilizzare file con estensione rdlc. Per utilizzare la modalità di elaborazione remota, è necessario disporre di una copia con licenza di Reporting Services versione SQL Server 2008 o successiva. L'elaborazione remota è destinata a organizzazioni che dispongono di un server di rapporti di SQL Server Reporting Services e desiderano utilizzare tale server unitamente ai controlli. Una soluzione basata su server garantisce maggior scalabilità e migliori prestazioni, offrendo inoltre funzionalità aggiuntive quali sottoscrizioni, memorizzazione nella cache e ulteriori formati di output per i rapporti. Per ulteriori informazioni sulla modalità di elaborazione remota, vedere Configurazione di ReportViewer per l'elaborazione remota e Distribuzione di rapporti e controlli ReportViewer.

In modalità di elaborazione remota non è possibile utilizzare file con estensione rdlc. Per utilizzare la modalità di elaborazione remota, è necessario disporre di una copia con licenza di Reporting Services versione SQL Server 2008 o successiva. L'elaborazione remota è destinata a organizzazioni che dispongono di un server di rapporti di SQL Server Reporting Services e desiderano utilizzare tale server unitamente ai controlli. Una soluzione basata su server garantisce maggior scalabilità e migliori prestazioni, offrendo inoltre funzionalità aggiuntive quali sottoscrizioni, memorizzazione nella cache e ulteriori formati di output per i rapporti. Per ulteriori informazioni sulla modalità di elaborazione remota, vedere Configurazione di ReportViewer per l'elaborazione remota e Distribuzione di rapporti e controlli ReportViewer.

Modalità di aggiunta e di configurazione di un controllo ReportViewer

Aggiungere un Windows Form o un Web Form a un progetto di .NET Framework 3.5 o 4.0.
In modalità progettazione grafica, trascinare il controllo ReportViewer dal gruppo Rapporto della Casella degli strumenti nel Windows Form o nel Web Form. Il controllo include un pannello smart tag Attività di ReportViewer per la selezione immediata del rapporto.

Il file web.config viene aggiornato automaticamente con il gestore HTTP per il controllo ReportViewer. Per ulteriori informazioni, vedere Impostazioni di Web.config per ReportViewer.

Nota

Per utilizzare il controllo ReportViewer in un Web Form, è inoltre necessario aggiungere un controllo ScriptManager alla pagina. Dalla finestra Casella degli strumenti, nel gruppo Estensioni AJAX trascinare un controllo ScriptManager nell'area di progettazione sopra il controllo ReportViewer.
Nel pannello smart tag Attività di ReportViewer selezionare le attività per aggiungere un rapporto e configurare il controllo. La specifica del rapporto consente di determinare se il controllo è configurato per l'elaborazione locale o remota.
- Fare clic su Progetta nuovo rapporto per avviare la Creazione guidata rapporto e creare un file di definizione del rapporto (con estensione rdlc) nell'applicazione. È possibile creare nell'applicazione nuovi rapporti che vengono elaborati in locale nel client. Per ulteriori informazioni sulla creazione di rapporti, vedere Creazione di file di definizione del rapporto del client (con estensione rdlc).
- Utilizzare Scegli rapporto per selezionare una definizione del rapporto esistente. È possibile scegliere un file di definizione del rapporto (con estensione rdlc) locale definito nel progetto oppure scegliere Rapporto server per selezionare un rapporto pubblicato in un server di rapporti di SQL Server 2008 Reporting Services.
  
  La selezione di un rapporto del server consente di configurare il controllo per l'elaborazione remota. Per selezionare un rapporto del server, è necessario conoscere l'URL del server di rapporti e il percorso del rapporto. Quando si fa riferimento a un rapporto in un server di rapporti in modalità nativa, il percorso del rapporto deve iniziare con una barra (/). Quando si fa riferimento a un rapporto in un server di rapporti in modalità integrata SharePoint, il percorso del rapporto è un URL completo. Ad esempio:
  
  Modalità nativa: /Adventureworks 2008 Sample Reports/Company Sales 2008
  
  Modalità integrata SharePoint: http://MyServer/sites/MySite/MyLibrary/Adventureworks 2008 Sample Reports/Company Sales 2008.rdl
  
  Per eseguire il rapporto, è necessario disporre dell'autorizzazione per l'accesso al rapporto nel server di rapporti. Se non si conosce l'URL o il percorso del rapporto, rivolgersi all'amministratore del server di rapporti. Per ulteriori informazioni sui rapporti del server, vedere Configurazione di ReportViewer per l'elaborazione remota.
  
  La selezione di un file di definizione del rapporto (con estensione rdlc) esistente consente di configurare il controllo per l'elaborazione locale. Per la selezione di un rapporto è necessario scegliere un file con estensione rdlc. Non è possibile specificare un file con estensione rdl anche se esistente nel progetto. Per ulteriori informazioni, vedere Creazione di file di definizione del rapporto del client (con estensione rdlc).
- Fare clic su Ancora nel contenitore padre per espandere l'area di visualizzazione del controllo ReportViewer in modo che utilizzi tutto lo spazio disponibile nel form o nella pagina. Questa opzione è disponibile con il controllo Windows Form.
- Fare clic su Riassocia origini dei dati per aggiornare le associazioni alle origini dei dati per tabelle di dati e oggetti business utilizzati nel rapporto. Questa opzione è disponibile dopo aver selezionato un rapporto per il controllo. È necessario riassociare i dati se si modifica un'origine dei dati del rapporto oppure un elemento del rapporto con associazione a dati all'esterno dell'ambiente di progettazione grafica del rapporto, ad esempio se si modifica direttamente il codice XML.
Selezionare il controllo ReportViewer e aprire la finestra Proprietà.
Impostare le proprietà nel controllo ReportViewer per determinare la visibilità e la disponibilità di aree di visualizzazione. Per informazioni sulle singole proprietà, vedere la documentazione di riferimento. Per ulteriori informazioni, vedere Proprietà ReportViewer. Per ulteriori informazioni sulla barra degli strumenti di ReportViewer, vedere Configurazione e utilizzo della barra degli strumenti di ReportViewer.
Compilare o distribuire l'applicazione per visualizzare l'anteprima del rapporto nel form o nella pagina.