共用方式為

逐步解說：建立支援複雜資料繫結的 Windows Form 使用者控制項

  • 發行項

 

發行︰ 2016年4月

在 Windows 應用程式中於表單上顯示資料時，您可以從 [工具箱] 中選擇現有控制項，或者，如果您的應用程式需要標準控制項中未提供的功能，也可以編寫自訂控制項。 這個逐步解說顯示如何建立可實作 ComplexBindingPropertiesAttribute 的控制項。 可實作 ComplexBindingPropertiesAttribute 的控制項包含可繫結至資料的 DataSource 和 DataMember 屬性。 這類控制項類似 DataGridView 或 ListBox。

如需控制項製作的詳細資訊，請參閱在設計階段開發 Windows Form 控制項。

製作控制項以用於資料繫結情節時，您需要實作下列其中一個資料繫結屬性：

資料繫結屬性使用方式
對顯示資料之單一資料行 (或屬性) 的簡單控制項 (如 TextBox)，實作 DefaultBindingPropertyAttribute 如需詳細資訊，請參閱逐步解說：建立支援簡單資料繫結的 Windows Form 使用者控制項。
對顯示資料之清單 (或資料表) 的控制項 (如 DataGridView)，實作 ComplexBindingPropertiesAttribute (這個逐步解說頁面會描述此流程)。
對顯示資料之清單 (或資料表) 但也需要呈現單一資料行或屬性的控制項 (如 ComboBox)，實作 LookupBindingPropertiesAttribute。 如需詳細資訊，請參閱逐步解說：建立支援查閱資料繫結的 Windows Form 使用者控制項。

這個逐步解說會建立顯示資料表中資料列的複雜控制項。 此範例使用 Northwind 範例資料庫中的 Customers 資料表。 複雜使用者控制項將會在自訂控制項的 DataGridView 中顯示 customers 資料表。

在這個逐步解說期間，您將了解如何：

  • 建立新的 [Windows 應用程式]。

  • 將新的 [使用者控制項] 加入至專案。

  • 透過視覺化方式設計使用者控制項。

  • 實作 ComplexBindingProperty 屬性。

  • 使用資料來源組態精靈建立資料集。

  • 在資料來源視窗中設定 [Customers] 資料表，以使用新的複雜控制項。

  • 加入新的控制項，方法是將它從 [資料來源] 視窗拖曳至 [Form1]。

必要條件

若要完成這個逐步解說，您將需要：

建立 Windows 應用程式

第一個步驟是建立 [Windows 應用程式]。

建立新的 Windows 專案

  1. 在 Visual Studio 中，從 [檔案] 功能表中建立新的 [專案]。

  2. 將專案命名為 ComplexControlWalkthrough。

  3. 選取 [Windows 應用程式]，然後按一下 [確定]。 如需詳細資訊，請參閱用戶端應用程式。

    隨即建立 [ComplexControlWalkthrough] 專案，並將它加入至 [方案總管]。

將使用者控制項加入至專案

因為這個逐步解說會從 [使用者控制項] 建立複雜資料可繫結控制項，所以您必須將 [使用者控制項] 項目加入至專案。

將使用者控制項加入至專案

  1. 從 [專案] 功能表中，選擇 [加入使用者控制項]。

  2. 在 [名稱] 區域中輸入 ComplexDataGridView，然後按一下 [加入]。

    [ComplexDataGridView] 控制項會加入至 [方案總管]，並在設計工具中予以開啟。

設計 ComplexDataGridView 控制項

此步驟會將 DataGridView 加入至使用者控制項。

設計 ComplexDataGridView 控制項

  • 將 DataGridView 從 [工具箱] 拖曳至使用者控制項的設計介面。

加入必要的資料繫結屬性

針對支援資料繫結的複雜控制項，您可以實作 ComplexBindingPropertiesAttribute。

實作 ComplexBindingProperties 屬性

  1. 將 [ComplexDataGridView] 控制項切換至程式碼檢視 (在 [檢視] 功能表上，選取 [程式碼])。

  2. 將 ComplexDataGridView 中的程式碼取代為下列內容：

    using System.Windows.Forms;

namespace CS
{
    [System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")]
    public partial class ComplexDataGridView : UserControl
    {
        public object DataSource
        {
            get{ return dataGridView1.DataSource; }
            set{ dataGridView1.DataSource = value; }
        }

        public string DataMember
        {
            get{ return dataGridView1.DataMember; }
            set{ dataGridView1.DataMember = value; }
        }

        public ComplexDataGridView()
        {
            InitializeComponent();
        }
    }
}

    <System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")>
Public Class ComplexDataGridView

    Public Property DataSource() As Object
        Get
            Return DataGridView1.DataSource
        End Get
        Set(ByVal value As Object)
            DataGridView1.DataSource = value
        End Set
    End Property

    Public Property DataMember() As String
        Get
            Return DataGridView1.DataMember
        End Get
        Set(ByVal value As String)
            DataGridView1.DataMember = value
        End Set
    End Property
End Class

  3. 從 [建置] 功能表中，選擇 [建置方案]。

從資料庫建立資料來源

此步驟使用 [資料來源組態精靈]，根據 Northwind 範例資料庫中的 Customers 資料表建立資料來源。 您必須具有 Northwind 範例資料庫的存取權，才能建立連接。 如需設定 Northwind 範例資料庫的詳細資訊，請參閱如何：安裝範例資料庫。

建立資料來源

  1. 按一下 [資料] 功能表上的 [顯示資料來源]。

  2. 在 [資料來源] 視窗中，選取 [加入新資料來源] 啟動 [資料來源組態精靈]。

  3. 請選取 [選擇資料來源類型] 頁面上的 [資料庫]，再按 [下一步]。

  4. 在 [選擇資料連接] 頁面上，執行下列其中一項：

    • 如果下拉式清單中有提供 Northwind 範例資料庫的資料連接，請選取這個資料連接。

      -或-

    • 選取 [新增連接]，啟動 [新增/修改連接] 對話方塊。

  5. 如果資料庫需要密碼，請選取選項來加入敏感性資料，然後按一下 [下一步]。

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

  7. 在 [選擇您的資料庫物件] 頁面上，展開 [資料表] 節點。

  8. 選取 Customers 資料表，然後按一下 [完成]。

    NorthwindDataSet 會加入專案中，且 Customers 資料表會出現在 [資料來源] 視窗中。

設定 Customers 資料表使用 ComplexDataGridView 控制項

在 [資料來源] 視窗內，您可以設定在將項目拖曳至表單之前建立控制項。

設定要繫結至 ComplexDataGridView 控制項的 Customers 資料表

  1. 在設計工具中，開啟 [Form1]。

  2. 在 [資料來源] 視窗中，展開 [Customers] 節點。

  3. 按一下 [Customers] 節點上的下拉箭號，並選擇 [自訂]。

  4. 在 [自訂資料欄位 UI 選項] 對話方塊中，從 [關聯的控制項] 清單中選取 [ComplexDataGridView]。

  5. 按一下 Customers 資料表上的下拉箭號，並從控制項清單中選擇 [ComplexDataGridView]。

將控制項加入至表單

將項目從 [資料來源] 視窗拖曳至表單，以建立資料繫結控制項。

在表單上建立資料繫結控制項

  • 將 [Customers] 主節點從 [資料來源] 視窗拖曳至表單，並確認使用 [ComplexDataGridView] 控制項來顯示資料表的資料。

執行應用程式

若要執行應用程式

  • 按 F5 執行應用程式。

後續步驟

根據應用程式的需求，在建立支援資料繫結的控制項之後，可能會有幾個想要執行的步驟。 一些一般後續步驟包括：

請參閱

設定從 [資料來源] 視窗拖曳時要建立的控制項
Windows Form 控制項
將 Windows Form 控制項繫結至 Visual Studio 中的資料
連接至 Visual Studio 中的資料
準備您的應用程式以接收資料
將資料擷取至您的應用程式中
將控制項繫結至 Visual Studio 中的資料
在您的應用程式中編輯資料
驗證資料
儲存資料