共用方式為

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

  • 發行項

 

發行︰ 2016年4月

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

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

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

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

這個逐步解說會建立繫結至兩張資料表中資料的查閱控制項。 此範例使用 Northwind 範例資料庫中的 Customers 和 Orders 資料表。 查閱控制項將會繫結至 Orders 資料表中的 CustomerID 欄位。 它將會使用此值查閱 Customers 資料表中的 CompanyName。

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

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

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

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

  • 實作 LookupBindingProperty 屬性。

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

  • 在 [資料來源] 視窗中，於 [Orders] 資料表中設定 [CustomerID] 資料行，以使用新的控制項。

  • 建立表單以顯示新控制項中的資料。

必要條件

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

建立 Windows 應用程式

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

建立新的 Windows 專案

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

  2. 將專案命名為 LookupControlWalkthrough。

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

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

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

這個逐步解說會從 [使用者控制項] 建立查閱控制項，進而將 [使用者控制項] 項目加入至 [LookupControlWalkthrough] 專案。

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

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

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

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

設計 LookupBox 控制項

設計 LookupBox 控制項

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

加入必要的資料繫結屬性

針對支援資料繫結的查閱控制項，您可以實作 LookupBindingPropertiesAttribute。

實作 LookupBindingProperties 屬性

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

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

    using System.Windows.Forms;

namespace CS
{
    [System.ComponentModel.LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "LookupMember")]
    public partial class LookupBox : UserControl
    {
        public object DataSource
        {
            get{ return comboBox1.DataSource; }
            set{ comboBox1.DataSource = value; }
        }

        public string DisplayMember
        {
            get{ return comboBox1.DisplayMember; }
            set{ comboBox1.DisplayMember = value; }
        }

        public string ValueMember
        {
            get{ return comboBox1.ValueMember; }
            set{ comboBox1.ValueMember = value; }
        }

        public string LookupMember
        {
            get{ return comboBox1.SelectedValue.ToString(); }
            set{ comboBox1.SelectedValue = value; }
        }


        public LookupBox()
        {
            InitializeComponent();
        }
    }
}

    <System.ComponentModel.LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "LookupMember")>
Public Class LookupBox

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

    Public Property DisplayMember() As String
        Get
            Return ComboBox1.DisplayMember
        End Get
        Set(ByVal value As String)
            ComboBox1.DisplayMember = value
        End Set
    End Property

    Public Property ValueMember() As String
        Get
            Return ComboBox1.ValueMember
        End Get
        Set(ByVal value As String)
            ComboBox1.ValueMember = value
        End Set
    End Property

    Public Property LookupMember() As String
        Get
            Return ComboBox1.SelectedValue.ToString()
        End Get
        Set(ByVal value As String)
            ComboBox1.SelectedValue = value
        End Set
    End Property
End Class

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

從資料庫建立資料來源

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

建立資料來源

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

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

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

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

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

      -或-

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

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

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

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

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

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

設定 Orders 資料表的 CustomerID 資料行使用 LookupBox 控制項

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

設定要繫結至 LookupBox 控制項的 CustomerID 資料行

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

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

  3. 展開 [Orders] 節點 (位於 [Customers] 節點的 [Fax] 資料行下方)。

  4. 按一下 [Orders] 節點上的下拉箭號，並從控制項清單中選擇 [詳細資料]。

  5. 按一下 [CustomerID] 資料行 (位於 [Orders] 節點中) 上的下拉箭號，並選擇 [自訂]。

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

  7. 按一下 [確定]。

  8. 按一下 [CustomerID] 資料行上的下拉箭號，並選擇 [LookupBox]。

將控制項加入至表單

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

在 Windows Form 上建立資料繫結控制項

  • 將 [Orders] 節點從 [資料來源] 視窗拖曳至 Windows Form，並確認使用 [LookupBox] 控制項來顯示 CustomerID 資料行中的資料。

繫結控制項以查閱 Customers 資料表中的 CompanyName

設定查閱繫結

  • 在 [資料來源] 視窗中選取 [Customers] 主節點，並將它拖曳至 [Form1] 的 [CustomerIDLookupBox] 中的下拉式方塊。

    這會設定資料繫結以顯示 Customers 資料表中的 CompanyName，同時維護 Orders 資料表中的 CustomerID 值。 如需詳細資訊，請參閱如何：在 Windows Form 應用程式中建立查閱資料表。

執行應用程式

若要執行應用程式

  • 按 F5 執行應用程式。

  • 巡覽部分記錄，並確認 CompanyName 出現在 LookupBox 控制項中。

請參閱

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