Distribuzione di rapporti e controlli ReportViewer

Articolo
08/31/2012

È possibile distribuire liberamente rapporti e controlli ReportViewer inclusi nell'applicazione.I requisiti di distribuzione variano notevolmente a seconda del tipo di controllo e dalla configurazione del rapporto per l'elaborazione locale o remota.È possibile distribuire nella stessa applicazione report elaborati in locale e in remoto.

Ridistribuzione dei controlli ReportViewer

Il pacchetto ridistribuibile del controllo ReportViewer è un file autoestraente denominato ReportViewer.exe che include un file con estensione msi e altri file.È inoltre possibile scaricare ReportViewer.exe dall'Area download Microsoft.

[!NOTA]

È possibile installare nello stesso computer versioni diverse del pacchetto ridistribuibile del controllo ReportViewer.

Quando si esegue ReportViewer.exe, vengono installati i file seguenti nella cartella Global Assembly Cache del computer di distribuzione.

Microsoft.ReportViewer.Common.dll
Microsoft.ReportViewer.ProcessingObjectModel.dll
Microsoft.ReportViewer.WebForms.dll
Microsoft.ReportViewer.WinForms.dll
Microsoft.ReportViewer.DataVisualization.dll

Esecuzione di ReportViewer.exe

La posizione in cui verrà eseguito ReportViewer.exe dipende dal tipo di controllo utilizzato.

In caso di applicazioni ASP.NET, eseguire ReportViewer.exe nel server Web che ospita l'applicazione.Questa operazione deve essere eseguita da un amministratore del server.
In caso di applicazioni ClickOnce di Windows Form, includere i controlli come prerequisito dell'applicazione, in modo che vengano installati automaticamente con l'applicazione ClickOnce.Per automatizzare questo passaggio, è possibile utilizzare il programma di avvio automatico:
1. Aprire la pagina delle proprietà del progetto.
2. Fare clic sulla scheda Pubblica, quindi sul pulsante Prerequisiti.
3. Selezionare Visualizzatore di report di Microsoft Visual Studio 2012 e Tipi CLR di SQL Server, quindi scegliere OK.
4. Assicurarsi che Scarica prerequisiti dal sito Web del fornitore del componente sia selezionata.Questa è l'unica opzione supportata.Scegliere quindi OK.
5. Fare clic sul pulsante Opzioni.
6. Nella scheda Distribuzione specificare una pagina Web di distribuzione e selezionare la casella di controllo Genera automaticamente pagina Web di distribuzione dopo ogni pubblicazione.
7. Scegliere OK e pubblicare l'applicazione.
Quando si accede a un'applicazione ClickOnce, ad esempio tramite una pagina Web, un controllo viene eseguito nel computer client per verificare se i prerequisiti di ReportViewer sono già installati.In caso contrario, verranno installati dal programma di installazione.

Distribuzione di versioni localizzate dei controlli ReportViewer

Il pacchetto ridistribuibile del controllo ReportViewer è localizzato nelle dieci lingue di Visual Studio: cinese semplificato, cinese tradizionale, francese, tedesco, italiano, giapponese, coreano, portoghese (Brasile), russo e spagnolo.Se si installa una versione localizzata di Visual Studio, è possibile scaricare qualsiasi pacchetto ridistribuibile di ReportViewer localizzato dall'Area download Microsoft.

Per utilizzare altre lingue in un controllo ReportViewer, è possibile implementare l'interfaccia IreportViewerMessages3 o IreportViewerMessages3 per creare descrizioni comandi e altro testo dell'interfaccia utente in una lingua specifica.

Rilevazione delle impostazioni cultura e della lingua del browser

Se il controllo del server Web ReportViewer è utilizzato per visualizzare i rapporti in un'applicazione browser, impostare la lingua del thread in modo da fornire un'interfaccia utente che corrisponda alle impostazioni cultura e della lingua del browser.L'impostazione cultura del thread non si basa sulle informazioni di intestazione fornite dal client in ASP.NET.Per adeguare l'applicazione alle impostazioni linguistiche del browser è possibile impostare Thread.CurrentCulture e Thread.CurrentUICulture nel codice dell'applicazione.Per ulteriori informazioni sull''utilizzo delle impostazioni linguistiche nell'applicazione, vedere System.Globalization.CultureInfo.

Considerazioni sulla distribuzione per il controllo del server Web ReportViewer

La distribuzione di un'applicazione ASP.NET in una Web farm implica ulteriori operazioni di configurazione per garantire il mantenimento dello stato di visualizzazione nell'ambito della farm.Se si intende distribuire il controllo del server Web ReportViewer in un ambiente di Web farm, è consigliabile specificare l'elemento machineKey nel file Web.config dell'applicazione.Per ulteriori informazioni, vedere Impostazioni di Web.config per ReportViewer.

I rapporti elaborati nel controllo del server Web ReportViewer prevedono requisiti variabili per il browser. I problemi di compatibilità del browser possono rendere non disponibili alcuni tipi di funzionalità dei rapporti.Per ulteriori informazioni, vedere Supporto del browser per controlli del server Web ReportViewer.

Distribuzione di file di rapporto

A meno che la definizione del rapporto del client non venga generata in modo dinamico in fase di esecuzione utilizzando il metodo LocalReport.LoadReportDefinition o ServerReport.LoadReportDefinition, sono disponibili diverse opzioni per distribuire i file di rapporto con l'applicazione, a seconda della modalità di elaborazione del controllo visualizzatore di rapporti.

I rapporti elaborati in locale possono essere archiviati in una cartella di rete o compilati nel file eseguibile dell'applicazione.I rapporti elaborati in un server remoto vengono in genere archiviati in un server di rapporti SQL Server Reporting Services.A meno che non si desideri utilizzare il metodo ServerReport.LoadReportDefinition per caricare manualmente un rapporto da una posizione diversa dal server di rapporti, non è disponibile alcun file di rapporto da includere nell'applicazione.Per distribuire rapporti pubblicati in un server di rapporti, è necessario fornire accesso continuativo a un server di rapporti e accertarsi che gli utenti dell'applicazione dispongano delle autorizzazioni necessarie per visualizzare i rapporti in tale server.Per distribuire rapporti del server è necessario conoscere il funzionamento dell'estensione per l'autenticazione utilizzata dal server e il modello di autorizzazione basata sui ruoli per l'accesso al contenuto e alle operazioni.Per ulteriori informazioni, vedere Considerazioni sulla distribuzione di rapporti del server.