Aggiunta e configurazione dei controlli ReportViewer
È possibile aggiungere una o più istanze di un controllo ReportViewer a un'applicazione Windows Form o ASP.NET trascinando il controllo dalla sezione Report della casella degli strumenti a una pagina o un form dell'applicazione. È possibile usare un pannello smart tag e le proprietà per configurare il controllo e associare il report. È anche possibile scrivere il codice se si desidera configurare il controllo a livello di programmazione.
Il controllo ReportViewer consente di visualizzare un report alla volta. Per visualizzare i report contemporaneamente, è possibile combinare più istanze del controllo sulla stessa pagina o form. È possibile usare anche una sola istanza del controllo in modo che venga visualizzato un solo report alla volta. Per visualizzare una sequenza di report mediante un singolo controllo, è necessario scrivere il codice che associa un report all'istanza del controllo ReportViewer da usare.
I controlli ReportViewer possono essere usati in modalità di elaborazione locale o remota.
In modalità di elaborazione locale il controllo apre una definizione del report, la elabora e quindi visualizza il report nell'area di visualizzazione. In modalità di elaborazione locale è possibile ottenere la definizione del report da un file con estensione rdlc del file system, da un flusso o da una risorsa incorporata nell'applicazione. Per altre informazioni, vedere ReportPath, LoadReportDefinition e ReportEmbeddedResource.
In modalità di elaborazione remota, il controllo recupera un report completamente elaborato da un server di report di Reporting Services. In modalità di elaborazione remota tutte le operazioni di elaborazione dei dati e dei report vengono eseguite nel server di report. La modalità di elaborazione remota viene in genere usata per i report pre-pubblicati, ma è anche possibile usarla per una definizione del report fornita con un flusso. Per altre informazioni, vedere LoadReportDefinition, ReportServerUrl e ReportPath.
Importante
In modalità di elaborazione remota non è infine possibile usare file con estensione rdlc.Per usare 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 report di SQL Server Reporting Services e desiderano usare tale server unitamente ai controlli.Una soluzione basata su server garantisce maggior scalabilità e migliori prestazioni, offrendo inoltre funzionalità aggiuntive quali sottoscrizioni, caching e altri formati di output per i report.Per altre 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.5.
In modalità progettazione grafica trascinare il controllo ReportViewer dal gruppo Report della Casella degli strumenti in Windows Form o Web Form. Il controllo include un pannello smart tag Attività di ReportViewer per la selezione immediata del report.
Il file web.config viene aggiornato automaticamente con il gestore HTTP per il controllo ReportViewer. Per altre informazioni, vedere Impostazioni di Web.config per ReportViewer.
Nota
Per usare 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 report e configurare il controllo. La specifica del report consente di determinare se il controllo è configurato per l'elaborazione locale o remota.
Fare clic su Progetta nuovo report per avviare la Creazione guidata report e creare un file di definizione del report (con estensione rdlc) nell'applicazione. È possibile creare nell'applicazione nuovi report che vengono elaborati in locale nel client. Per altre informazioni sulla creazione di report, vedere Creazione di file di definizione del rapporto del client (con estensione rdlc).
Usare Scegli report per selezionare una definizione del report esistente. È possibile scegliere un file di definizione del report (con estensione rdlc) locale definito nel progetto oppure scegliere Report server per selezionare un report pubblicato in un server di report di SQL Server 2008 Reporting Services.
La selezione di un report del server consente di configurare il controllo per l'elaborazione remota. Per selezionare un report del server, è necessario conoscere l'URL del server di report e il percorso del report. Quando si fa riferimento a un report in un server di report in modalità nativa, il percorso del report deve iniziare con una barra (/). Quando si fa riferimento a un report in un server di report in modalità integrata SharePoint, il percorso del report è 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 report, è necessario disporre dell'autorizzazione sul server di report per l'accesso al report. Se non si conosce l'URL o il percorso del report, rivolgersi all'amministratore del server di report. Per altre informazioni sui report del server, vedere Configurazione di ReportViewer per l'elaborazione remota.
La selezione di un file di definizione del report (con estensione rdlc) esistente consente di configurare il controllo per l'elaborazione locale. Per la selezione di un report è necessario scegliere un file con estensione rdlc. Non è possibile specificare un file con estensione rdl anche se esistente nel progetto. Per altre 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 usi 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 usati nel report. Questa opzione è disponibile dopo aver selezionato un report per il controllo. È necessario riassociare i dati se si modifica un'origine dei dati del report oppure un elemento del report con associazione a dati all'esterno dell'ambiente di progettazione grafica del report, 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 proprietà, usare la documentazione di riferimento. Per ulteriori informazioni, vedere Proprietà ReportViewer. Per 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 report nel form o nella pagina.
Vedere anche
Concetti
Utilizzo del riquadro degli smart tag delle attività di ReportViewer
Creazione di file di definizione del rapporto del client (con estensione rdlc)
Configurazione di ReportViewer per l'elaborazione locale
Configurazione di ReportViewer per l'elaborazione remota
Controlli del server Web e Windows Form di ReportViewer