Configurazione di sottoreport e report drill-through (Progettazione report di Visual Studio)

È possibile utilizzare sottoreport e report drill-through per collegare report correlati.

• Un sottoreport è un controllo incorporato nel corpo di un report padre. A livello concettuale, un sottoreport è simile a un frame in una pagina Web che funge da contenitore per altro contenuto della pagina Web. Il rendering del sottoreport viene eseguito all'interno del report padre che lo contiene. Entrambi i report vengono elaborati e visualizzati contemporaneamente.

• Un report drill-through viene creato in seguito a un'azione drill-through impostata su un elemento del report. Questa azione di norma apre un report correlato o lo stesso report con parametri diversi nello spazio del report padre. Il report drill-through è in genere correlato al report padre tramite i dati. Un tipico esempio di report drill-through è costituito da un report relativo alle vendite mensili che contiene collegamenti ai singoli ordini di vendita per il mese. Quando si fa clic su un collegamento drill-through, il report padre viene sostituito con un report diverso che include i dettagli supportati.

Sia nei report drill-through che nei sottoreport è supportata la nozione di report padre e report figlio. Per correlare i report, è necessario creare parametri che consentono di passare i dati per la definizione della relazione. Per collegare i report in fase di esecuzione, è invece necessario scrivere codice che supporti la connessione. Durante la distribuzione di report correlati, accertarsi che i file di definizione del report del client (con estensione rdlc) siano archiviati insieme nella stessa cartella nel file system.

Gli eventi seguenti includono codice di esempio in cui viene illustrato come implementare sottoreport e azioni drill-through per il controllo ReportViewer:

• Microsoft.Reporting.WebForms.ReportViewer.Drillthrough

• Microsoft.Reporting.WebForms.LocalReport.SubreportProcessing

• Microsoft.Reporting.WinForms.ReportViewer.Drillthrough

• Microsoft.Reporting.WinForms.LocalReport.SubreportProcessing

Per informazioni sull'inserimento di interattività drill-down nel report, vedere Procedura: disattivare o definire la visibilità degli elementi Toggle in un elemento del report (Progettazione report di Visual Studio).

Aggiunta di sottoreport

Un sottoreport e il corrispondente report padre possono essere correlati tramite parametri condivisi. I parametri devono essere aggiunti a ciascun report e configurati prima di aggiungere un sottoreport al report padre. Durante l'aggiunta del sottoreport il report padre viene configurato in modo da passare i parametri al sottoreport.

Per aggiungere un sottoreport

1. Aprire il file di definizione del report del client (con estensione rdlc) in modalità progettazione grafica.

2. Fare clic su Sottoreport nella casella degli strumenti.

3. Nell'area di progettazione trascinare il mouse fino a tracciare un riquadro delle dimensioni desiderate per il sottoreport. In alternativa, fare clic nell'area di progettazione per creare un sottoreport di dimensioni fisse.

   Nota
   Se il sottoreport esiste già nel progetto, per crearlo è sufficiente trascinare il report da Esplora soluzioni nell'area di progettazione.

4. Fare clic con il pulsante destro del mouse sul sottoreport e quindi scegliere Proprietà.

5. In Sottoreport selezionare il report da visualizzare nell'area del sottoreport.

6. Nella scheda Parametri eseguire le operazioni seguenti:

   • Nella casella Nome parametro digitare il nome di un parametro per il sottoreport. Questo nome deve corrispondere a un parametro di report incluso nel report indicato nella proprietà ReportName.

   • Nella casella Valore parametro digitare un valore da passare al sottoreport. È possibile specificare un testo statico o un'espressione che punti a un campo o a un altro oggetto nel report padre.

7. Ripetere il passaggio 2 per aggiungere altri parametri da passare al sottoreport.

Nota
Nell'elenco Parametri devono essere inclusi tutti i parametri necessari per il sottoreport. Se manca un parametro obbligatorio, il sottoreport non verrà visualizzato correttamente nel report padre.

Per fornire i dati per i sottoreport, l'applicazione deve gestire l'evento SubreportProcessing dell'oggetto LocalReport. Uno degli argomenti passati al metodo del gestore dell'evento SubreportProcessing è SubreportProcessingEventArgs. Nel gestore dell'evento l'applicazione può esaminare i valori dei parametri passati al sottoreport utilizzando la proprietà Parameters di SubreportProcessingEventArgs. L'applicazione deve quindi fornire i dati per il sottoreport utilizzando la proprietà DataSources di SubreportProcessingEventArgs.

Configurazione di report drill-through

Per configurare i report drill-through, è possibile definire azioni di drill-through per offrire funzionalità di spostamento da un report padre a un report secondario che contiene i dati supportati.

Un report drill-through contiene in genere i parametri passati a tale report dal report padre. Nell'esempio di report di riepilogo delle vendite il report drill-through contiene un parametro che accetta l'ordine come valore. Nel report di riepilogo è incluso un collegamento al report drill-through per ogni numero di ordine che, se selezionato, consente di aprire il report di dettagli di destinazione e di passare a tale report l'ID dell'ordine desiderato.

Qualsiasi report archiviato nel server di report può essere un report drill-through. È possibile aggiungere collegamenti drill-through solo a caselle di testo e immagini.

Per aggiungere un collegamento a un report drill-through

1. Aprire il file di definizione del report del client (con estensione rdlc) in modalità progettazione grafica.

2. Fare clic con il pulsante destro del mouse sulla casella di testo o sull'immagine a cui si desidera aggiungere un collegamento e quindi scegliere Proprietà.

3. Nella scheda Spostamento selezionare Passa a report.

4. Digitare o selezionare il nome di un report. Il report deve essere un file con estensione rdlc incluso nello stesso progetto.

5. Per impostare i parametri da passare al report drill-through, fare clic su Parametri e quindi eseguire le operazioni seguenti:

   • Nella casella Nome parametro digitare i nomi dei parametri del report nel report drill-through.

     Nota
     I nomi nell'elenco dei parametri devono corrispondere esattamente ai parametri previsti nel report di destinazione. Se i nomi non corrispondono o un parametro previsto non è presente nell'elenco, il report drill-through darà errore.

   • Nella casella Valore parametro digitare o selezionare i valori da passare ai parametri nel report drill-through.

     Nota
     I valori possono contenere un'espressione che restituisce un valore da passare al parametro del report. Le espressioni nell'elenco dei valori includono l'elenco dei campi per il report corrente.

Per fornire i dati per i report drill-through, l'applicazione deve gestire l'evento Drillthrough dell'oggetto ReportViewer. Uno degli argomenti passati al metodo del gestore dell'evento Drillthrough è DrillthroughEventArgs. DrillThroughEventArgs include una proprietà Report che rappresenta il report drill-through. Nel gestore dell'evento l'applicazione host può esaminare i valori dei parametri passati al report drill-through chiamando su tale report il metodo GetParameters(). L'applicazione host deve quindi fornire i dati per il report drill-through utilizzando la proprietà DataSources del report.

Vedere anche

Concetti

Definizione dei parametri del report (Progettazione report di Visual Studio)
Aggiunta delle funzionalità di interattività, visibilità e spostamento a un report (Progettazione report di Visual Studio)

Altre risorse

Esempi e scenari