Procedura dettagliata: associazione dati semplice 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 Word 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

Word 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 nei progetti a livello di applicazione. In questa procedura dettagliata viene illustrato come aggiungere controlli a un documento di Microsoft Office Word e come associare in fase di esecuzione i controlli ai dati.

Vengono illustrate le attività seguenti:

Aggiunta di ContentControl a un documento in fase di esecuzione.
Creazione di un oggetto BindingSource che connette il controllo a un'istanza di un dataset.
Attivazione per scorrere i record e visualizzarli nel controllo.

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.
Word 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 componente aggiuntivo per Word.

Per creare un nuovo progetto

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

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

In Visual Studio viene aperto il file ThisAddIn.vb o ThisAddIn.cs e il progetto Popolamento di documenti 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 Customer (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 Customer (SalesLT) nel database AdventureWorksLT.
- Un oggetto TableAdapter denominato CustomerTableAdapter. È 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

L'interfaccia per la visualizzazione dei record di database in questa procedura dettagliata è molto semplice e viene creata direttamente all'interno del documento. In un oggetto ContentControl viene visualizzato un solo record di database per volta, mentre due controlli Button consentono di spostarsi avanti e indietro attraverso i record. Il controllo del contenuto utilizza un oggetto BindingSource per il collegamento al database.

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

Per creare l'interfaccia nel documento

Nella classe ThisAddIn, dichiarare i controlli indicati di seguito per visualizzare e scorrere la tabella Customer del database AdventureWorksLTDataSet.

Private adventureWorksDataSet As AdventureWorksLTDataSet
Private customerTableAdapter As AdventureWorksLTDataSetTableAdapters.CustomerTableAdapter
Private customerBindingSource As System.Windows.Forms.BindingSource
Private customerContentControl As Microsoft.Office.Tools.Word.RichTextContentControl
Private WithEvents button1 As Microsoft.Office.Tools.Word.Controls.Button
Private WithEvents button2 As Microsoft.Office.Tools.Word.Controls.Button

private AdventureWorksLTDataSet adventureWorksDataSet;
private AdventureWorksLTDataSetTableAdapters.CustomerTableAdapter customerTableAdapter;
private System.Windows.Forms.BindingSource customerBindingSource;
private Microsoft.Office.Tools.Word.RichTextContentControl customerContentControl;
private Microsoft.Office.Tools.Word.Controls.Button button1;
private Microsoft.Office.Tools.Word.Controls.Button button2;

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

Me.adventureWorksDataSet = New AdventureWorksLTDataSet()
Me.customerTableAdapter = New AdventureWorksLTDataSetTableAdapters.CustomerTableAdapter()
Me.customerTableAdapter.Fill(Me.adventureWorksDataSet.Customer)
Me.customerBindingSource = New System.Windows.Forms.BindingSource()

this.adventureWorksDataSet = new AdventureWorksLTDataSet();
this.customerTableAdapter = new AdventureWorksLTDataSetTableAdapters.CustomerTableAdapter();
this.customerTableAdapter.Fill(this.adventureWorksDataSet.Customer);
this.customerBindingSource = new System.Windows.Forms.BindingSource();

Aggiungere al metodo ThisAddIn_Startup il seguente codice. Viene generato un elemento host che estende il documento. 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 currentDocument As Word.Document = Me.Application.ActiveDocument
Dim extendedDocument As Document = currentDocument.GetVstoObject()
```
```
Word.Document currentDocument = this.Application.ActiveDocument;
Document extendedDocument = currentDocument.GetVstoObject();
```

Definire diversi intervalli all'inizio del documento. Tali intervalli identificano il punto in cui inserire il testo e posizionare i controlli.

extendedDocument.Paragraphs(1).Range.InsertParagraphBefore()
extendedDocument.Paragraphs(1).Range.InsertParagraphBefore()
extendedDocument.Paragraphs(1).Range.Text = "The companies listed in the AdventureWorksLT database:   "

extendedDocument.Paragraphs(2).Range.Text = "  "

Dim range1 As Word.Range = extendedDocument.Paragraphs(2).Range.Characters.First
Dim range2 As Word.Range = extendedDocument.Paragraphs(2).Range.Characters.Last
Dim range3 As Word.Range = extendedDocument.Paragraphs(1).Range.Characters.Last

extendedDocument.Paragraphs[1].Range.InsertParagraphBefore();
extendedDocument.Paragraphs[1].Range.InsertParagraphBefore();
extendedDocument.Paragraphs[1].Range.Text = 
    "The companies listed in the AdventureWorksLT database:   \n";
extendedDocument.Paragraphs[2].Range.Text = "  "; 

Word.Range range1 = extendedDocument.Paragraphs[2].Range.Characters.First;
Word.Range range2 = extendedDocument.Paragraphs[2].Range.Characters.Last;
Word.Range range3 = extendedDocument.Paragraphs[1].Range.Characters.Last;

Aggiungere i controlli dell'interfaccia agli intervalli precedentemente definiti.

Me.button1 = extendedDocument.Controls.AddButton(range1, 60, 15, "1")
Me.button1.Text = "Previous"
Me.button2 = extendedDocument.Controls.AddButton(range2, 60, 15, "2")
Me.button2.Text = "Next"

Me.customerContentControl = extendedDocument.Controls.AddRichTextContentControl( _
    range3, _
    "richTextContentControl1")

this.button1 = extendedDocument.Controls.AddButton(range1, 60, 15, "1");
this.button1.Text = "Previous";
this.button2 = extendedDocument.Controls.AddButton(range2, 60, 15, "2");
this.button2.Text = "Next";

this.customerContentControl = extendedDocument.Controls.AddRichTextContentControl(
    range3,
    "richTextContentControl1");

Associare il controllo del contenuto all'oggetto AdventureWorksLTDataSet tramite BindingSource. Gli sviluppatori C# devono aggiungere due gestori eventi per i controlli Button.

Me.customerBindingSource.DataSource = Me.adventureWorksDataSet.Customer
Me.customerContentControl.DataBindings.Add( _
    "Text", _
    Me.customerBindingSource, _
    "CompanyName", _
    True, _
    Me.customerContentControl.DataBindings.DefaultDataSourceUpdateMode)

this.customerBindingSource.DataSource = this.adventureWorksDataSet.Customer;
this.customerContentControl.DataBindings.Add(
    "Text", 
    this.customerBindingSource, 
    "CompanyName", 
    true,
    this.customerContentControl.DataBindings.DefaultDataSourceUpdateMode);

this.button1.Click += new EventHandler(button1_Click);
this.button2.Click += new EventHandler(button2_Click);

Aggiungere il codice seguente per spostarsi tra i record del database.

Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
    Handles button1.Click
    Me.customerBindingSource.MovePrevious()
End Sub

Private Sub button2_Click(ByVal sender As Object, ByVal e As EventArgs) _
    Handles button2.Click
    Me.customerBindingSource.MoveNext()
End Sub

void button1_Click(object sender, EventArgs e)
{
    this.customerBindingSource.MovePrevious();
}

void button2_Click(object sender, EventArgs e)
{
    this.customerBindingSource.MoveNext();
}

Test del componente aggiuntivo

Quando si apre Word, nel controllo del contenuto vengono visualizzati i dati del dataset AdventureWorksLTDataSet. Scorrere i record del database facendo clic sui pulsanti Avanti e Indietro.

Per verificare il componente aggiuntivo

Premere F5.

Viene creato un controllo del contenuto denominato customerContentControl che viene popolato con i dati. Contemporaneamente, al progetto vengono aggiunti un oggetto dataset denominato adventureWorksLTDataSet e un oggetto BindingSource denominato customerBindingSource. ContentControl viene associato all'oggetto BindingSource, che a sua volta è associato all'oggetto dataset.
Fare clic sui pulsanti Avanti e Indietro per scorrere i record del database.

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.

Share via