逐步解說:建立支援複雜資料繫結的使用者控制項
更新:2007 年 11 月
在 Windows 應用程式中顯示表單的資料時,您可以從 [工具箱] 中選擇現有的控制項,但如果應用程式需要標準控制項中沒有的功能時,您也可以撰寫自訂控制項。本逐步解說將示範如何建立實作 ComplexBindingPropertiesAttribute 的控制項。實作 ComplexBindingPropertiesAttribute 的控制項會包含可繫結至資料的 DataSource 和 DataMember 屬性。這類控制項與 DataGridView 或 ListBox 很相似。
如需控制項撰寫的詳細資訊,請參閱在設計階段開發 Windows Form 控制項。
當您在撰寫控制項以便用於資料繫結案例時,就必須實作下列其中一個資料繫結屬性 (Attribute):
資料繫結屬性使用方式 |
---|
在可顯示單一資料行 (或屬性) 的簡單控制項 (例如 TextBox) 上實作 DefaultBindingPropertyAttribute。如需詳細資訊,請參閱逐步解說:建立支援簡單資料繫結的使用者控制項。 |
在可顯示資料清單 (或資料表) 的控制項 (例如 DataGridView) 上實作 ComplexBindingPropertiesAttribute。(這個處理會在此逐步解說頁中描述)。 |
在可顯示資料清單 (或資料表) 但同時需要呈現單一資料行或屬性的控制項 (例如 ComboBox) 上實作 LookupBindingPropertiesAttribute。如需詳細資訊,請參閱逐步解說:建立支援查閱資料繫結的使用者控制項。 |
這個逐步解說會建立複雜控制項,以便顯示來自資料表中各資料列的資料。這個範例會使用 Northwind 範例資料庫的 Customers 資料表。此複雜使用者控制項將會在自訂控制項中以 DataGridView 顯示 customers 資料表。
在瀏覽這份逐步解說期間,您將了解如何:
建立新的 [Windows 應用程式]。
將新的 [使用者控制項] 加入到專案中。
視覺化地設計使用者控制項。
實作 ComplexBindingProperty 屬性。
使用資料來源組態精靈建立資料集。
在資料來源視窗中,將 Customers 資料表設定為使用新的複雜控制項。
加入新的控制項,方法是從 [資料來源] 視窗將它拖曳至 [Form1]。
必要條件
若要完成這個逐步解說,您必須要有:
- Northwind 範例資料庫的存取權。如需詳細資訊,請參閱 HOW TO:安裝範例資料庫。
建立 Windows 應用程式
第一個步驟是要建立一個 [Windows 應用程式]。
若要建立新的 Windows 專案
在 Visual Studio 中,從 [檔案] 功能表建立新的 [專案]。
將專案命名為 ComplexControlWalkthrough。
選取 [Windows 應用程式],並按 [確定]。如需詳細資訊,請參閱建立 Windows 架構的應用程式。
[ComplexControlWalkthrough] 專案隨即建立並加入至 [方案總管]。
將使用者控制項加入至專案
由於這個逐步解說會從 [使用者控制項] 建立複雜的可資料繫結控制項,所以您必須將 [使用者控制項] 項目加入至專案中。
若要將使用者控制項加入專案中
從 [專案] 功能表中選擇 [加入使用者控制項]。
在 [名稱] 區域中輸入 ComplexDataGridView,然後按一下 [加入]。
[ComplexDataGridView] 控制項就會加入至 [方案總管] 並在設計工具中開啟。
設計 ComplexDataGridView 控制項
這個步驟會將 DataGridView 加入至使用者控制項中。
若要設計 ComplexDataGridView 控制項
- 從 [工具箱] 將 DataGridView 拖曳到使用者控制項的設計介面上。
加入必要的資料繫結屬性
針對支援資料繫結的複雜控制項,您可以實作 ComplexBindingPropertiesAttribute。
若要實作 ComplexBindingProperties 屬性
將 [ComplexDataGridView] 控制項切換成程式碼檢視 (在 [檢視] 功能表上,選取 [程式碼])。
用下列程式碼取代 ComplexDataGridView 中的程式碼:
<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
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(); } } }
從 [建置] 功能表中,選擇 [建置方案]。
從資料庫中建立資料來源
這個步驟會使用 [資料來源組態精靈],根據 Northwind 範例資料庫的 Customers 資料表來建立資料來源。您必須可以存取 Northwind 範例資料庫,才能建立連接。如需設定 Northwind 範例資料庫的詳細資訊,請參閱 HOW TO:安裝範例資料庫。
若要建立資料來源
在 [資料] 功能表上按一下 [顯示資料來源]。
在 [資料來源] 視窗中,選取 [加入新資料來源],以啟動 [資料來源組態精靈]。
選取 [選擇資料來源類型] 頁面上的 [資料庫],再按 [下一步]。
在 [選擇資料連接] 頁面上,執行下列其中一項動作:
如果下拉式清單中有提供 Northwind 範例資料庫的資料連接,請選取這個資料連接。
-或-
選取 [新增連接],啟動 [新增/修改連接] 對話方塊。如需詳細資訊,請參閱新增/修改連接對話方塊 (一般)。
如果您的資料庫需要密碼,請選取這個選項來加入敏感性資料,然後按一下 [下一步]。
按一下 [將連接字串儲存到應用程式組態檔] 頁面上的 [下一步]。
在 [選擇您的資料庫物件] 頁面上,展開 [資料表] 節點。
選取 Customers 資料表,再按一下 [完成]。
[NorthwindDataSet] 會加入專案中,而且 Customers 資料表會出現在 [資料來源] 視窗中。
將 Customers 資料表設定成使用 ComplexDataGridView 控制項
在將項目拖曳到表單之前,您可以先在 [資料來源] 視窗內設定要建立的控制項。
若要將 Customers 資料表設定成繫結至 ComplexDataGridView 控制項
在設計工具中開啟 [Form1]。
在 [資料來源] 視窗中,展開 [Customers] 節點。
按一下 [Customers] 節點上的下拉箭號,然後選擇 [自訂]。
在 [自訂資料欄位 UI 選項] 對話方塊中,從 [關聯的控制項] 清單中選取 [ComplexDataGridView]。
按一下 Customers 資料表上的下拉箭號,然後從控制項清單中選擇 [ComplexDataGridView]。
將控制項加入到表單中
您可以從 [資料來源] 視窗將項目拖曳至表單上,藉以建立資料繫結控制項。
若要在表單上建立資料繫結控制項
- 從 [資料來源] 視窗,將 [Customers] 主節點拖曳至表單上,然後確定 [ComplexDataGridView] 控制項會用來顯示資料表的資料。
執行應用程式
若要執行應用程式
- 請按 F5 以執行應用程式。
後續步驟
根據應用程式的需求而定,您在建立支援資料繫結的控制項後,可能還會想執行幾個步驟。接下來一般的步驟包括:
將自訂控制項放置在控制項程式庫中,以便您可以在其他應用程式中重複使用它們。如需詳細資訊,請參閱 Windows 控制項程式庫範本。
建立支援查閱案例的控制項。如需詳細資訊,請參閱 逐步解說:建立支援查閱資料繫結的使用者控制項。