Procedura dettagliata: associazione dati complessa in un progetto a livello di applicazione

Articolo
04/28/2010

Aggiornamento: Luglio 2008

Si applica a
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto Progetti a livello di applicazione Versione Microsoft Office Excel 2007 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati.

Tipo di progetto

Progetti a livello di applicazione

Versione Microsoft Office

Excel 2007

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

A partire da Visual Studio 2008 Service Pack 1 (SP1), è possibile associare dati ai controlli host e ai controlli Windows Form in progetti a livello di applicazione. In questa procedura dettagliata viene illustrato come aggiungere controlli a un foglio di lavoro di Microsoft Office Excel e come associare in fase di esecuzione i controlli ai dati.

Vengono illustrate le attività seguenti:

Aggiunta di un controllo ListObject a un foglio di lavoro in fase di esecuzione.
Creazione di un oggetto BindingSource che connette il controllo a un'istanza di un dataset.

Nota:
Nel computer in uso è possibile che vengano visualizzati nomi o percorsi diversi per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per ulteriori informazioni vedere Impostazioni di Visual Studio.

Prerequisiti

Per completare la procedura dettagliata è necessario disporre dei componenti elencati di seguito.

Visual Studio Tools per Office°(componente facoltativo di Visual Studio 2008 Professional e Visual Studio Team System).

Visual Studio Tools per Office viene installato per impostazione predefinita con le versioni di Visual Studio elencate. Per controllare se è installato, vedere Installazione di Visual Studio Tools per Office.
Excel 2007.
Accesso a un'istanza in esecuzione di SQL Server 2005 o SQL Server 2005 Express a cui è collegato il database di esempio AdventureWorksLT. È possibile scaricare il database AdventureWorksLT dal sito Web CodePlex. Per ulteriori informazioni sul collegamento di un database, vedere gli argomenti seguenti:
- Per collegare un database tramite SQL Server Management Studio o SQL Server Management Studio Express, vedere Procedura: Collegamento di un database (SQL Server Management Studio).
- Per collegare un database tramite la riga di comando, vedere Procedura: Collegamento di un file di database a SQL Server Express.

Creazione di un nuovo progetto

Il primo passaggio consiste nella creazione di un progetto per un componente aggiuntivo di Excel.

Per creare un nuovo progetto

Creare un progetto Componente aggiuntivo per Excel 2007 denominato Popolamento di fogli di lavoro da un database, utilizzando Visual Basic o C#.

Per ulteriori informazioni, vedere la classe Procedura: creare progetti Visual Studio Tools per Office.

Viene aperto il file ThisAddIn.vb o ThisAddIn.cs e il progetto Popolamento di fogli di lavoro da un database viene aggiunto a Esplora soluzioni.

Creazione di un'origine dati

Utilizzare la finestra Origini dati per aggiungere un DataSet tipizzato al progetto.

Per aggiungere un dataset tipizzato al progetto

Scegliere Aggiungi nuova origine dati dal menu Dati.

Verrà avviata la Configurazione guidata origine dati.
Fare clic su Database, quindi scegliere Avanti.
Se già si dispone di una connessione al database AdventureWorksLT, scegliere questa connessione e fare clic su Avanti.

In caso contrario, scegliere Nuova connessione e utilizzare la finestra di dialogo Aggiungi connessione per creare la nuova connessione. Per ulteriori informazioni, vedere la classe Procedura: creare connessioni a database di SQL Server.
Scegliere Avanti nella pagina Salva stringa di connessione nel file di configurazione dell'applicazione.
Nella pagina Seleziona oggetti di database, espandere Tabelle e selezionare Address (SalesLT).
Scegliere Fine.

Il file AdventureWorksLTDataSet.xsd viene aggiunto a Esplora soluzioni. Tale file definisce gli elementi seguenti:
- Un dataset tipizzato denominato AdventureWorksLTDataSet. Questo dataset rappresenta il contenuto della tabella Address (SalesLT) nel database AdventureWorksLT.
- Un oggetto TableAdapter denominato AddressTableAdapter. È possibile utilizzare questo oggetto TableAdapter per leggere e scrivere dati in AdventureWorksLTDataSet. Per ulteriori informazioni, vedere la classe Cenni preliminari sugli oggetti TableAdapter.
Nei passaggi successivi della procedura dettagliata si utilizzeranno entrambi gli oggetti.

Creazione di controlli e associazione dei controlli ai dati

In questa procedura dettagliata, il controllo ListObject visualizza tutti i dati della tabella selezionata appena l'utente apre la cartella di lavoro. L'oggetto elenco utilizza un oggetto BindingSource per connettere il controllo al database.

Per ulteriori informazioni sull'associazione dei controlli ai dati, vedere Associazione di dati ai controlli.

Per aggiungere l'oggetto elenco, il dataset e il TableAdapter

Nella classe ThisAddIn, dichiarare i controlli indicati di seguito per visualizzare e la tabella Address del dataset AdventureWorksLTDataSet.

Private addressListObject As Microsoft.Office.Tools.Excel.ListObject
Private adventureWorksDataSet As AdventureWorksLTDataSet
Private addressTableAdapter As AdventureWorksLTDataSetTableAdapters.AddressTableAdapter
Private addressBindingSource As System.Windows.Forms.BindingSource

private Microsoft.Office.Tools.Excel.ListObject addressListObject;
private AdventureWorksLTDataSet adventureWorksDataSet;
private AdventureWorksLTDataSetTableAdapters.AddressTableAdapter addressTableAdapter;
private System.Windows.Forms.BindingSource addressBindingSource;

Nel metodo ThisAddIn_Startup, aggiungere il codice seguente per inizializzare il dataset e inserirvi le informazioni contenute nel dataset AdventureWorksLTDataSet.

Me.addressTableAdapter = New AdventureWorksLTDataSetTableAdapters.AddressTableAdapter()
Me.adventureWorksDataSet = New AdventureWorksLTDataSet()
Me.addressTableAdapter.Fill(Me.adventureWorksDataSet.Address)
Me.addressBindingSource = New System.Windows.Forms.BindingSource()

this.addressTableAdapter = new AdventureWorksLTDataSetTableAdapters.AddressTableAdapter();
this.adventureWorksDataSet = new AdventureWorksLTDataSet();
this.addressTableAdapter.Fill(this.adventureWorksDataSet.Address);
this.addressBindingSource = new System.Windows.Forms.BindingSource();

Aggiungere al metodo ThisAddIn_Startup il seguente codice. Viene generato un elemento host che estende il foglio di lavoro. Per ulteriori informazioni, vedere la classe Estensione in fase di esecuzione di documenti di Word e di cartelle di lavoro di Excel in componenti aggiuntivi a livello di applicazione.

Dim worksheet As Excel.Worksheet = DirectCast(Me.Application.ActiveWorkbook.Worksheets(1), Excel.Worksheet)
Dim extendedWorksheet As Worksheet = worksheet.GetVstoObject()

Excel.Worksheet worksheet = (Excel.Worksheet)this.Application.ActiveWorkbook.Worksheets[1];
Worksheet extendedWorksheet = worksheet.GetVstoObject();

Creare un intervallo e aggiungere il controllo ListObject.

Dim cell As Excel.Range = extendedWorksheet.Range("$A$1:$G$5", System.Type.Missing)
Me.addressListObject = extendedWorksheet.Controls.AddListObject(cell, "list1")

Excel.Range cell = extendedWorksheet.Range["$A$1:$G$5", System.Type.Missing];
this.addressListObject = extendedWorksheet.Controls.AddListObject(cell, "list1");

Associare il controllo del contenuto a AdventureWorksLTDataSet tramite BindingSource. Passare i nomi delle colonne che si desidera associare all'oggetto elenco.

Me.addressBindingSource.DataSource = Me.adventureWorksDataSet.Address
Me.addressListObject.AutoSetDataBoundColumnHeaders = True
Me.addressListObject.SetDataBinding( _
    Me.addressBindingSource, "", "AddressID", "AddressLine1", _
    "AddressLine2", "City", "StateProvince", "CountryRegion", "PostalCode")

this.addressBindingSource.DataSource = this.adventureWorksDataSet.Address;
this.addressListObject.AutoSetDataBoundColumnHeaders = true;
this.addressListObject.SetDataBinding(
    this.addressBindingSource, "", "AddressID", "AddressLine1", 
    "AddressLine2", "City", "StateProvince", "CountryRegion", "PostalCode");

Test del componente aggiuntivo

Quando si apre Excel, il controllo ListObject visualizza i dati della tabella Address del dataset AdventureWorksLTDataSet.

Per verificare il componente aggiuntivo

Premere F5.

Nel foglio di lavoro viene creato un nuovo controllo ListObject denominato addressListObject. Contemporaneamente, al progetto vengono aggiunti un oggetto dataset denominato adventureWorksLTDataSet e un oggetto BindingSource denominato addressBindingSource. ListObject viene associato all'oggetto BindingSource, che a sua volta è associato all'oggetto dataset.

Vedere anche

Cronologia delle modifiche

Date	History	Motivo
Luglio 2008	Argomento aggiunto.	Modifica di funzionalità in SP1.

Luglio 2008

Argomento aggiunto.

Modifica di funzionalità in SP1.

Condividi tramite