逐步解說：VSTO 載入宏專案中的簡單數據系結

  • 發行項

您可以將資料繫結至 VSTO 增益集專案中的主控制項和 Windows Form 控制項。 本逐步解說示範如何將控制項加入 Microsoft Office Word 文件，以及在執行階段將控制項繫結至資料。

適用於： 本主題中的資訊適用於 Word 的 VSTO 載入宏專案。 如需詳細資訊，請參閱 Office 應用程式 lication 和項目類型所提供的功能。

本逐步解說將說明下列工作：

  • 在設計階段將 ContentControl 加入文件。

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

  • 讓使用者能夠捲動記錄及在控制項中檢視它們。

注意

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

必要條件

您需要下列元件才能完成這個逐步解說：

建立新專案

第一步是建立 Word VSTO 增益集專案。

建立新的專案

  1. 使用 Visual Basic 或 C#，建立名稱為 [ 從資料庫填入文件] 的 Word VSTO 增益集專案。

    如需詳細資訊，請參閱 如何：在Visual Studio中建立 Office專案。

    Visual Studio 會開啟 ThisAddIn.vb 或 ThisAddIn.cs 檔案，並將 [填入的檔] 從資料庫專案新增至 方案總管。

  2. 如果您的專案以 .NET Framework 4 或 .NET Framework 4.5 為目標，請新增 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 元件的參考。 本逐步解說稍後會需要用到此參考，以透過程式設計的方式將 Windows Forms 控制項加入文件。

建立資料來源

使用 [ 資料來源 ] 視窗將型別資料集加入專案。

將具類型資料集加入專案

  1. 如果看不到 [數據源] 視窗，請在功能表欄上選擇 [檢視>其他 Windows>數據源] 來顯示它。

  2. 選擇 [ 加入新資料來源 ] 以啟動 [ 資料來源組態精靈]。

  3. 按一下 [ 資料庫]，然後按 [ 下一步]。

  4. 如果您有 AdventureWorksLT 資料庫的現有連接，請選擇這個連接，然後按 [ 下一步]。

    否則，請按一下 [ 新增連接]，然後使用 [ 加入連接 ] 對話方塊建立新的連接。 如需詳細資訊，請參閱新增連線。

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

  6. 在 [ 選擇您的資料庫物件 ] 頁面中，展開 [ 資料表 ]，然後選取 [ Customer (SalesLT)]。

  7. 按一下完成。

    AdventureWorksLTDataSet.xsd 檔案會新增至 方案總管。 這個檔案會定義下列項目：

    • 具類型資料集，名稱為 AdventureWorksLTDataSet。 此資料集代表 AdventureWorksLT 資料庫中 Customer (SalesLT) 資料表的內容。

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

      您將在本逐步解說稍後用到這兩個物件。

建立控件並將控件系結至數據

本逐步解說中用來檢視資料庫記錄的介面是基本的，而且會直接在檔內建立。 一個 ContentControl 一次顯示單一資料庫記錄，而兩個 Button 控制項可讓您來回捲動記錄。 內容控制項使用 BindingSource 連接到資料庫。

如需將控件系結至數據的詳細資訊，請參閱 將數據系結至 Office 方案中的控件。

在文件中建立介面

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

    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 資料庫的資訊。

    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 方法。 這會產生可擴充文件的主項目。 如需詳細資訊，請參閱 在運行時間擴充 VSTO 載入宏中的 Word 檔和 Excel 活頁簿。

    Word.Document currentDocument = this.Application.ActiveDocument;

Document extendedDocument = Globals.Factory.GetVstoObject(currentDocument);

  4. 在文件開頭定義數個範圍。 這些範圍會識別插入文字和放置控制項的位置。

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

    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. 使用 AdventureWorksLTDataSet 將內容控制項繫結至 BindingSource。 C# 開發人員請加入 Button 控制項的兩個事件處理常式。

    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. 加入下列程式碼來瀏覽資料庫記錄。

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

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

測試載入宏

當您開啟 Word 時，內容控制項會顯示來自 AdventureWorksLTDataSet 資料集的資料。 按 [ 下一個 ] 和 [ 前一個 ] 按鈕，即可捲動資料庫記錄。

測試 VSTO 增益集

  1. 請按 F5。

    會建立名為 customerContentControl 的內容控制項並填入資料。 同時間，名為 adventureWorksLTDataSet 的資料集物件，和名為 BindingSource 的 customerBindingSource 會加入專案。 ContentControl 已繫結至 BindingSource，而後者又繫結至資料集物件。

  2. 按 [ 下一個 ] 和 [ 前一個 ] 按鈕，即可捲動資料庫記錄。

相關內容