萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> Div CSS 教學

DevExpress LookUpEdit 數據綁定實戰:WPF 實體類綁定完整範例

前言

DevExpress WPF LookUpEdit 是常用的下拉選擇控件。本文記錄實際踩坑經驗:GridControl 的 Name 必須設為 PART_GridControl 才能正常綁定實體類,並提供完整 XAML 與後端代碼範例。

問題背景

明明代碼邏輯正確,但下拉列表無數據。經調試發現,LookUpEdit 內部依賴 GridControl 模板部件,若 Name 不為 PART_GridControl,內部邏輯無法找到網格,導致綁定失效。

完整 XAML 範例

<dxe:LookUpEdit
    Name="txtSupplierId"
    DisplayMember="id"
    AutoPopulateColumns="False"
    AutoComplete="True"
    IncrementalFiltering="True"
    ImmediatePopup="True"
    IsPopupAutoWidth="False"
    HorizontalAlignment="Stretch"
    VerticalAlignment="Stretch"
    IsTextEditable="False"
    SelectedIndex="-1"
    PopupOpening="chooseSupplierId">

    <dxe:LookUpEdit.PopupContentTemplate>
        <ControlTemplate>
            <dxg:GridControl Name="PART_GridControl" />
        </ControlTemplate>
    </dxe:LookUpEdit.PopupContentTemplate>
</dxe:LookUpEdit>

關鍵點:GridControl 的 Name="PART_GridControl" 不可省略或改名。

後端綁定代碼 (C#)

private void chooseSupplierId(object sender, RoutedEventArgs e)
{
    var data = new List<SupplierData>();
    data.Add(new SupplierData { Id = "1", Name = "供應商 A", Address = "台北市" });
    data.Add(new SupplierData { Id = "2", Name = "供應商 B", Address = "新北市" });
    
    txtSupplierId.ItemsSource = data; // 綁定數據源
}

public class SupplierData
{
    public string Id { get; set; }
    public string Name { get; set; }
    public string Address { get; set; }
}

關鍵屬性說明

屬性說明
DisplayMember下拉顯示的屬性名稱(此處為 "id")
ValueMember實際綁定值的屬性(未設定時同 DisplayMember)
AutoPopulateColumnsFalse 表示手動定義欄位,True 自動生成
IncrementalFiltering輸入時即時過濾
PopupOpening彈出前事件,適合動態載入數據

常見坑點總結

  1. GridControl Name 錯誤:必須為 PART_GridControl。
  2. DisplayMember/ValueMember 拼寫錯誤:需與實體類屬性名完全一致(區分大小寫)。
  3. ItemsSource 綁定時機:建議在 PopupOpening 事件中動態載入,避免啟動時效能負擔。
  4. 實體類需為 Public 且屬性有 get/set。

結語

DevExpress 控件功能強大但細節多,LookUpEdit 綁定實體類的核心在於 PART_GridControl 命名規範。掌握此點,即可順利實現下拉選擇與數據綁定。

copyright © 萬盛學電腦網 all rights reserved