Procedura dettagliata: creazione di un rapporto di ReportViewer

Articolo
08/31/2012

In questa procedura dettagliata viene illustrato come creare un semplice rapporto tabella in un progetto di applicazione Windows Form di Visual Studio basato sul database di esempio AdventureWorks2008.Nella procedura viene aggiunto un rapporto al progetto utilizzando la Creazione guidata rapporto e viene aggiunto un controllo Windows Form ReportViewer a Windows Form, in modo che il rapporto possa essere visualizzato dagli utenti dell'applicazione.

Per ulteriori informazioni sulla progettazione di rapporti tramite Progettazione rapporti di Visual Studio, vedere Progettazione rapporto (Visual Studio).

Prerequisiti

Per utilizzare questa procedura dettagliata, è necessario poter accedere al database di esempio AdventureWorks2008.La query utilizzata in questa procedura dettagliata non funziona con una versione precedente di AdventureWorks.Per ulteriori informazioni su come ottenere il database di esempio AdventureWorks2008, vedere Procedura dettagliata: installazione del database AdventureWorks.

Questa procedura dettagliata presuppone la conoscenza delle query Transact-SQL e degli oggetti DataSet e DataTable ADO.NET.

Per creare un nuovo progetto di applicazione Windows Form

Aprire Visual Studio.Scegliere Nuovo dal menu File e quindi selezionare Progetto.
Nel riquadro Modelli installati espandere Altri linguaggi e selezionare Visual Basic.
Scegliere Applicazione Windows Form.
Nella casella Nome digitare SimpleReport.
Nella casella Percorso immettere la directory in cui si desidera salvare il progetto oppure fare clic su Sfoglia per selezionarla.
Fare clic su OK.

Verrà aperto Progettazione Windows Form in cui è visualizzato l'oggetto Form1 del progetto creato.
Fare clic sul form.Scegliere Finestra Proprietà dal menu Visualizza.Espandere la proprietà Size per visualizzare Width e Height.Impostare Width su 500 pixel.

Per definire un set di dati e una tabella dati

Scegliere Aggiungi nuovo elemento dal menu Progetto.
Nella finestra di dialogo Aggiungi nuovo elemento fare clic su DataSet.Digitare un nome per il nuovo set di dati e fare clic su Aggiungi.Il nome predefinito è DataSet1.xsd.

In questo modo verrà aggiunto un nuovo file XSD al progetto e verrà aperto Progettazione DataSet.
Dalla Casella degli strumenti in Progettazione DataSet trascinare un controllo TableAdapter sull'area di progettazione.

In questo modo verrà avviata la Configurazione guidata TableAdapter.
Nella pagina Scegliere la connessione dati fare clic su Nuova connessione.
Se è la prima volta che si crea un'origine dati in Visual Studio, verrà visualizzata la pagina Scegli origine dati.Nella finestra di dialogo Origine dati selezionare Microsoft SQL Server.
Nella finestra di dialogo Aggiungi connessione attenersi alla procedura seguente:
- Nella casella Nome server immettere il server in cui è contenuto il database AdventureWorks2008.
  
  L'istanza di SQL Server Express predefinita è (local)\sqlexpress.
- Nella sezione Accesso al server selezionare l'opzione per l'accesso ai dati.L'impostazione predefinita è Usa autenticazione di Windows.
- Nell'elenco a discesa Seleziona o immetti nome di database fare clic su AdventureWorks2008.
- Fare clic su OK per tornare alla procedura guidata, quindi su Avanti.
Se al passaggio precedente è stata specificata l'opzione Usa autenticazione di SQL Server, scegliere se includere i dati sensibili nella stringa o se impostare le informazioni nel codice dell'applicazione.
Nella pagina Salva stringa di connessione nel file di configurazione dell'applicazione digitare il nome per la stringa di connessione o accettare il nome predefinito AdventureWorks2008ConnectionString.Fare clic su Avanti.
Nella pagina Seleziona un tipo di comando selezionare Usa istruzioni SQL e fare clic su Avanti.

Nella pagina Immettere un'istruzione SQL immettere la query Transact-SQL seguente per recuperare i dati di vendita dal database AdventureWorks2008, quindi fare clic su Fine:

--SET DATEFORMAT mdy

SELECT      
   PC.Name AS Category, PS.Name AS Subcategory, 
   DATEPART(yy, SOH.OrderDate) AS Year, 
   'Q' + DATENAME(qq, SOH.OrderDate) AS Qtr, 
   SUM(DET.UnitPrice * DET.OrderQty) AS Sales
FROM Production.ProductSubcategory PS INNER JOIN
   Sales.SalesOrderHeader SOH INNER JOIN
      Sales.SalesOrderDetail DET ON SOH.SalesOrderID = DET.SalesOrderID INNER JOIN
      Production.Product P ON DET.ProductID = P.ProductID 
      ON PS.ProductSubcategoryID = P.ProductSubcategoryID INNER JOIN
   Production.ProductCategory PC ON PS.ProductCategoryID = PC.ProductCategoryID
WHERE (SOH.OrderDate BETWEEN ('20020101') AND ('20031231'))
GROUP BY DATEPART(yy, SOH.OrderDate), PC.Name, PS.Name, 
   'Q' + DATENAME(qq, SOH.OrderDate), PS.ProductSubcategoryID

È anche possibile fare clic sul pulsante Generatore di query e utilizzare il generatore di query per creare una query e convalidarla facendo clic sul pulsante Esegui query.

Fare clic su Fine.

In Progettazione DataSet verrà visualizzata la definizione DataTable per DataTable1 con i campi denominati in base alle colonne e agli alias di colonna della query (Category, Subcategory, Year, Qtr e Sales).I campi verranno utilizzati durante l'associazione dei dati al rapporto.

[!NOTA]

Se è necessario modificare i campi nella tabella dati, fare clic con il pulsante destro del mouse sull'intestazione DataTable1 o sull'intestazione DataTable1TableAdapter nella pagina Progettazione DataSet.Scegliere Configura. La Configurazione guidata TableAdapter verrà riavviata.
Salvare il file DataSet1.

Per aggiungere un nuovo file di definizione del rapporto utilizzando la Creazione guidata rapporto

Scegliere Aggiungi nuovo elemento dal menu Progetto.
Nella finestra di dialogo Aggiungi nuovo elemento fare clic su Creazione guidata rapporto.
In Nome digitare Sales Orders.rdlc, quindi fare clic su Aggiungi.

Verrà aperta un'area di progettazione grafica dietro alla finestra di dialogo.
Nella pagina Proprietà set di dati selezionare l'oggetto DataSet creato nell'elenco Origine dati.

La casella Set di dati disponibili viene aggiornata automaticamente con l'oggetto DataTable creato.
Fare clic su Avanti.
Nella pagina Disponi campi effettuare le operazioni seguenti:
1. Trascinare Category da Campi disponibili alla casella Gruppi di righe.
2. Trascinare Subcategory da Campi disponibili alla casella Gruppi di righe, sotto Category.
3. Trascinare Year da Campi disponibili alla casella Gruppi di colonne.
4. Trascinare Qtr da Campi disponibili alla casella Gruppi di colonne, sotto Year.
5. Trascinare Sales da Campi disponibili alla casella Valori.
Fare clic due volte su Avanti, quindi fare clic su Fine.

Verrà creato il file con estensione rdlc, che verrà aperto in Progettazione rapporti.L'oggetto Tablix progettato sarà ora visualizzato nell'area di progettazione.

Per aggiungere un titolo al rapporto

Fare clic sull'oggetto Tablix nell'area di progettazione in modo che gli handle di colonna e di riga vengano visualizzati sopra e accanto alla tabella.

[!NOTA]

Gli handle sono rappresentati da caselle di colore grigio visualizzate sopra e accanto all'oggetto Tablix.È possibile utilizzare gli handle per eseguire diverse azioni sui gruppi di colonne e di righe e sull'oggetto Tablix stesso.Gli handle nella parte superiore dell'oggetto Tablix sono handle di colonna,mentre quelli laterali sono handle di riga.L'handle disponibile nel punto di incontro tra gli handle di riga e di colonna è l'handle d'angolo.
Fare clic sull'handle d'angolo per selezionare l'intero oggetto Tablix, visualizzando la freccia a quattro punte.
Spostare l'oggetto Tablix verso il basso nell'area di progettazione trascinando la freccia a quattro punte.
Dalla casella degli strumenti trascinare un elemento Casella di testo sopra l'oggetto Tablix nell'area di progettazione, quindi posizionarlo trascinando la freccia a quattro punte.
Con la casella di testo selezionata, digitare Company Sales.Se necessario, trascinare il bordo della casella di testo per espanderlo.
Con la casella di testo selezionata, fare clic sul pulsante Grassetto sulla barra degli strumenti Formattazione rapporto, quindi selezionare 16 pt nella casella Dimensione carattere.
Con la casella di testo selezionata, fare clic sul pulsante Colore primo piano sulla barra degli strumenti Formattazione rapporto.
Nella finestra di dialogo Scegli colore selezionare il colore Blu notte e fare clic su OK.

Per aggiungere il controllo ReportViewer al form

In Esplora soluzioni fare clic su Form1.vb.
Scegliere Finestra di progettazione dal menu Visualizza.
Dalla sezione Rapporto della casella degli strumenti trascinare il controllo ReportViewer nel form.
Aprire il pannello smart tag del controllo ReportViewer1 facendo clic sul glifo dello smart tag nell'angolo in alto a destra.Fare clic sull'elenco a discesa Scegli rapporto e selezionare SimpleReport.Sales Orders.rdlc.
Scegliere Ancora nel contenitore padre dal pannello smart tag.

È possibile compilare l'applicazione e visualizzare il rapporto nel form in qualsiasi momento nel resto di questa procedura dettagliata.Per verificare in che modo le modifiche incrementali apportate nel corso della progettazione influiscono sul rapporto finale, compilare e visualizzare il rapporto come ultimo passaggio in ognuna delle procedure descritte di seguito.
(Facoltativo) Premere F5 per compilare l'applicazione e visualizzare il rapporto nel form.

Per formattare un campo di tipo valuta

Nella finestra Progettazione rapporti per il file Sales Orders.rdlc fare clic con il pulsante destro del mouse sulla cella in alto a destra con il valore [Sum(Sales)] e quindi scegliere Proprietà casella di testo.
Selezionare la scheda Numero.
Nell'elenco Categoria selezionare Valuta.
Nell'elenco Simbolo selezionare Inglese (Regno Unito).
Fare clic su OK per chiudere la finestra di dialogo.
Eseguire gli stessi passaggi in tutte le altre celle con il valore [Sum(Sales)].
(Facoltativo) Premere F5 per compilare l'applicazione e visualizzare il rapporto.Osservare la modifica del formato numerico.Si noti che non viene effettuata alcuna conversione della valuta, ma viene modificato solo il formato numerico.

Per formattare il layout dell'oggetto Tablix

Nella finestra Progettazione rapporti per il file Sales Orders.rdlc trascinare il cursore per selezionare le due celle vuote nell'angolo in alto a sinistra dell'oggetto Tablix.
Fare clic con il pulsante destro del mouse sulle celle selezionate e scegliere Unisci celle.
Fare clic con il pulsante destro del mouse sulla cella unita e scegliere Proprietà casella di testo.
Fare clic sulla scheda Bordo.Nell'area Anteprima fare clic sui pulsanti che consentono di visualizzare e nascondere il bordo per rimuovere i bordi superiore e sinistro.
Fare clic su OK.
Fare clic sull'oggetto Tablix per visualizzare gli handle.Per la colonna con l'intestazione Subcategory, espandere la larghezza della colonna trascinando il lato destro dell'handle di colonna.In questo modo, è possibile impedire che il testo dell'intestazione vada a capo nella riga successiva.
Premere F5 per compilare l'applicazione e visualizzare il rapporto.

Vedere anche

Share via