共用方式為


逐步解說:應用程式層級專案中的簡單資料繫結

更新: 2008 年 7 月

適用於

本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。

專案類型

  • 應用程式層級專案

Microsoft Office 版本

  • Word 2007

如需詳細資訊,請參閱依應用程式和專案類型提供的功能

從 Visual Studio 2008 Service Pack 1 (SP1) 開始,您可以透過應用程式層級專案,將資料繫結至主控制項和 Windows Form 控制項。本逐步解說示範如何在執行階段將控制項加入至 Microsoft Office Word 文件,以及將控制項繫結至資料。

這個逐步解說將說明下列工作:

  • 在執行階段將 ContentControl 加入至文件。

  • 建立可將控制項連接至資料集執行個體的 BindingSource

  • 讓使用者可以捲動記錄,並用此控制項檢視這些記錄。

注意事項:

您的電腦可能會在下列說明中,以不同名稱或位置顯示某些 Visual Studio 使用者介面項目。您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。如需詳細資訊,請參閱 Visual Studio 設定

必要條件

您需要下列元件才能完成此逐步解說:

  • Visual Studio Tools for Office (Visual Studio 2008 Professional 和 Visual Studio Team System 的選擇性元件)。

    Visual Studio Tools for Office 預設會與列出的 Visual Studio 版本一併安裝。若要查看是否已安裝,請參閱 安裝 Visual Studio Tools for Office

  • Word 2007。

  • 存取附加了 AdventureWorksLT 範例資料庫之執行中的 SQL Server 2005 或 SQL Server 2005 Express 執行個體。您可以從 CodePlex 網站 (本頁面可能為英文) 下載 AdventureWorksLT 資料庫。如需附加資料庫的詳細資訊,請參閱下列主題:

建立新專案

首先,必須建立 Word 增益集專案。

若要建立新的專案

  • 使用 Visual Basic 或 C#,建立名為從資料庫填入文件的 [Word 2007 增益集] 專案。

    如需詳細資訊,請參閱 HOW TO:建立 Visual Studio Tools for Office 專案

    Visual Studio 隨即開啟 ThisAddIn.vb 或 ThisAddIn.cs 檔案,並將從資料庫填入文件專案加入至 [方案總管]。

建立資料來源

請使用 [資料來源] 視窗,將具型別資料集加入您的專案。

若要將具型別資料集加入至專案

  1. 在 [資料] 功能表上,按一下 [加入新資料來源]。

    [資料來源組態精靈] 隨即開啟。

  2. 按一下 [資料庫],然後按 [下一步]。

  3. 如果已經有現有的 AdventureWorksLT 資料庫連接,請選擇此連接,再按 [下一步]。

    否則,請按一下 [新增連接],並使用 [加入連接] 對話方塊建立新連接。如需詳細資訊,請參閱 HOW TO:建立連接至 SQL Server 資料庫

  4. 在 [將連接字串儲存到應用程式組態檔] 頁面上,按 [下一步]。

  5. 在 [選擇您的資料庫物件] 頁面中,展開 [資料表],並選取 [客戶 (SalesLT)]。

  6. 按一下 [完成]。

    AdventureWorksLTDataSet.xsd 檔案隨即加入至 [方案總管]。這個檔案定義下列項目:

    • 名稱為 AdventureWorksLTDataSet 的具型別資料集。這個資料集代表 AdventureWorksLT 資料庫中 客戶 (SalesLT) 資料表的內容。

    • 名為 CustomerTableAdapter 的 TableAdapter。這個 TableAdapter 可以用來讀取和寫入 AdventureWorksLTDataSet 中的資料。如需詳細資訊,請參閱 TableAdapter 概觀

    在這個逐步解說後面的步驟中,您會用到這兩個物件。

建立控制項並將控制項繫結至資料

本逐步解說用來檢視資料庫記錄的是非常基本的介面,而這個介面是直接建立在文件裡面。介面中的 ContentControl 會一次顯示一筆資料庫記錄,而另外兩個 Button 控制項可讓您來回捲動記錄。內容控制項會使用 BindingSource 來連接資料庫。

如需將控制項繫結至資料的詳細資訊,請參閱將資料繫結至控制項

若要在文件中建立介面

  1. 在 ThisAddIn 類別中,宣告下列控制項以顯示並捲動 AdventureWorksLTDataSet 資料庫的 Customer 資料表。

    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;
    
  2. 在 ThisAddIn_Startup 方法中加入下列程式碼以初始化該資料集,並以 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();
    
  3. 將以下程式碼加入至 ThisAddIn_Startup 方法中。這會產生可擴充文件的主項目。如需詳細資訊,請參閱在應用程式層級增益集的執行階段中擴充 Word 文件和 Excel 活頁簿

    Dim currentDocument As Word.Document = Me.Application.ActiveDocument
    Dim extendedDocument As Document = currentDocument.GetVstoObject()
    
    Word.Document currentDocument = this.Application.ActiveDocument;
    Document extendedDocument = currentDocument.GetVstoObject();
    
  4. 在文件的開頭定義數個範圍。這些範圍會識別文字插入和控制項放置的位置。

    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;
    
  5. 將介面控制項加入至前面定義的範圍。

    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");
    
  6. 使用 BindingSource,將內容控制項繫結至 AdventureWorksLTDataSet。如果是 C# 開發人員,請為 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);
    
  7. 加入下列程式碼以巡覽資料庫記錄。

    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();
    }
    

測試增益集

當您開啟 Word 時,內容控制項會顯示 AdventureWorksLTDataSet 資料集中的資料。請按 [下一筆] 和 [上一筆] 按鈕,捲動資料庫記錄。

若要測試增益集

  1. 請按 F5。

    名為 customerContentControl 的內容控制項隨即建立,而且會填入資料。同時,也會將名為 adventureWorksLTDataSet 的資料集物件和名為 customerBindingSource 的 BindingSource 加入至專案。ContentControl 會繫結至 BindingSource,而後者則繫結至資料集物件。

  2. 請按 [下一筆] 和 [上一筆] 按鈕,捲動資料庫記錄。

請參閱

工作

HOW TO:將資料庫的資料填入工作表

HOW TO:將資料庫的資料填入文件

HOW TO:將服務的資料填入文件

HOW TO:將物件的資料填入文件

HOW TO:在工作表中捲動資料庫記錄

HOW TO:從主控制項中使用資料更新資料來源

逐步解說:文件層級專案中的簡單資料繫結

逐步解說:文件層級專案中的複雜資料繫結

HOW TO:將物件的資料填入文件

HOW TO:從主控制項中使用資料更新資料來源

概念

將資料繫結至控制項

使用在 Office 方案概觀中的本機資料庫檔案

資料來源概觀

顯示資料概觀

使用在 Office 方案概觀中的本機資料庫檔案

連接至 Visual Studio 中的資料概觀

參考

BindingSource 元件概觀

其他資源

Office 方案的資料

變更記錄

日期

記錄

原因

2008 年 7 月

加入主題。

SP1 功能變更。