Procedura dettagliata: utilizzo di un'origine dei dati di oggetti business con il controllo Windows Form di ReportViewer in modalità di elaborazione locale

Articolo
08/22/2008

In questa procedura dettagliata viene illustrato il modo in cui utilizzare l'origine dei dati di un oggetto tramite oggetti business in un'applicazione Windows creata in Microsoft Visual Studio 2008. Per ulteriori informazioni sugli oggetti business e le origini dei dati degli oggetti, vedere Associazione a oggetti business

Per aggiungere un report a un progetto di applicazione Windows in Visual Studio, eseguire la procedura seguente. In questo esempio l'applicazione verrà creata in Microsoft Visual C#.

Creazione di un nuovo progetto di applicazione Windows

Scegliere Nuovo dal menu File e quindi selezionare Progetto.
Nella finestra di dialogo Nuovo progetto, in Visual C#, scegliere il modello Applicazione Windows.
Digitare BusinessObject quale nome del progetto e fare clic su OK.

Creazione di oggetti business da utilizzare come origine dei dati

Scegliere Aggiungi nuovo elemento dal menu Progetto.
Nella finestra di dialogo Aggiungi nuovo elemento selezionare Classe, digitare il nome file BusinessObjects.cs e fare clic su Aggiungi. Il nuovo file viene aggiunto al progetto e automaticamente aperto in Visual Studio.

Sostituire il codice predefinito di BusinessObjects.cs con il codice seguente:

using System;
using System.Collections.Generic;

// Define the Business Object "Product" with two public properties
//    of simple datatypes.
public class Product {
    private string m_name;
    private int m_price;

    public Product(string name, int price) {
        m_name = name;
        m_price = price;
    }

    public string Name {
        get {
            return m_name;
        }
    }

    public int Price {
        get {
            return m_price;
        }
    }
}

// Define Business Object "Merchant" that provides a 
//    GetProducts method that returns a collection of 
//    Product objects.

public class Merchant {
    private List<Product> m_products;

    public Merchant() {
        m_products = new List<Product>();
        m_products.Add(new Product("Pen", 25));
        m_products.Add(new Product("Pencil", 30));
        m_products.Add(new Product("Notebook", 15));
    }

    public List<Product> GetProducts() {
        return m_products;
    }
}

Scegliere Genera soluzione dal menu Progetto. In questo modo viene creato un assembly per l'oggetto, che verrà successivamente utilizzato come origine dei dati per il report.

Aggiunta di un report al progetto

Verificare che il progetto o un elemento del progetto sia selezionato in Esplora soluzioni.
Scegliere Aggiungi nuovo elemento dal menu Progetto.
Nella finestra di dialogo Aggiungi nuovo elemento selezionare Report. Digitare un nome per il report e fare clic su Aggiungi. Il report verrà aggiunto al progetto e automaticamente aperto in Progettazione report. Per impostazione predefinita, il nome del report è Report1.rdlc.

Utilizzo della Configurazione guidata origine dati per creare un'origine dei dati

Verificare che il progetto o un elemento del progetto sia selezionato in Esplora soluzioni.
Scegliere Aggiungi nuova origine dei dati dal menu Dati. In questo modo verrà avviata la Configurazione guidata origine dati.
Nella pagina Selezionare un tipo di origine dati selezionare Oggetto e fare clic su Avanti.
Nella Configurazione guidata origine dati verrà visualizzato un elenco delle classi esistenti nel progetto. Espandere la gerarchia delle classi sotto BusinessObjects fino a visualizzare Prodotto nell'elenco. Selezionare Prodotto, fare clic su Avantie quindi su Fine.

Dopo aver chiuso la procedura guidata, il nuovo oggetto origine dei dati viene visualizzato nella finestra Origini dei dati.

Progettazione del report

Dopo aver aperto il report in modalità di progettazione, aprire la Casella degli strumenti. Trascinare un controllo Tabella nel report dalla Casella degli strumenti. Il controllo tabella verrà visualizzato nella finestra di visualizzazione della progettazione del report. Si noti che lo sfondo punteggiato rappresenta le dimensioni del corpo del report ed è possibile ridimensionare o riposizionare il controllo tabella.
Dalla finestra Origini dei dati trascinare il campo Nome dall'origine dei dati Prodotto nella prima colonna della riga Dettaglio della tabella. La riga Dettaglio è quella centrale. La riga Intestazione viene completata automaticamente quando si specifica la riga Dettaglio.

Nota

Se la finestra Origini dei dati non è visibile, scegliere Mostra origini dati dal menu Dati.
Trascinare il campo Prezzo nella riga Dettaglio della seconda colonna in modo che sia posizionato accanto al campo Nome. Facoltativamente, selezionare la riga di intestazione della tabella facendo clic sull'icona dell'intestazione della tabella sinistra e applicare come stile del carattere Grassetto.
Eliminare la terza colonna poiché inutilizzata. Fare clic sulla terza colonna, quindi sulla barra dell'intestazione e premere CANC.
Per aggiungere un titolo al report, aprire la Casella degli strumenti e trascinare un controllo Casella di testo nel report. Posizionare la Casella di testo sopra la tabella. Digitare Prodotti quale nome del report.
Facoltativamente, applicare le dimensioni e lo stile del carattere al testo per mettere in evidenza il titolo.

Nota
Se la finestra Origini dei dati non è visibile, scegliere Mostra origini dati dal menu Dati.

Aggiunta di un controllo ReportViewer al report

Selezionare il form dell'applicazione Windows generato automaticamente in visualizzazione Progettazione. Per impostazione predefinita, il nome del form è Form1.cs.
Aprire la Casella degli strumenti. Nella Casella degli strumenti espandere il nodo Dati e trascinare l'icona ReportViewer nel form. Espandere il form e riposizionare ReportViewer in base alle esigenze.
Selezionare il controllo ReportViewer e aprire il riquadro degli smart tag facendo clic sul triangolo nell'angolo in alto a destra. Fare clic sull'elenco a discesa Scegli report e selezionare il report progettato. Per impostazione predefinita, il nome del report è Report1.rdlc. Viene creato automaticamente un oggetto BindingSource corrispondente a ogni origine dei dati degli oggetti utilizzata nel report.

Implementazione di istanze dell'origine dei dati per l'oggetto BindingSource

Fare clic con il pulsante destro del mouse sul form Visual Studio e scegliere Visualizza codice dal menu di scelta rapida.
In Form1.cs aggiungere il codice seguente al di sopra della classe. È possibile utilizzare la prima riga dopo l'istruzione public partial class Form1 : Form { e prima del costruttore.
```
// Instantiate the Merchant class.
private Merchant m_merchant = new Merchant();
```

Nel metodo Form1_Load() aggiungere il codice seguente come prima riga, prima della chiamata a RefreshReport:

// Bind the Product collection to the DataSource.
this.ProductBindingSource.DataSource = m_merchant.GetProducts();

Esecuzione dell'applicazione

Premere F5 per eseguire l'applicazione e visualizzare il report.

Vedere anche

Condividi tramite