DevExpress WPF LookUpEdit 是常用的下拉選擇控件。本文記錄實際踩坑經驗:GridControl 的 Name 必須設為 PART_GridControl 才能正常綁定實體類,並提供完整 XAML 與後端代碼範例。
明明代碼邏輯正確,但下拉列表無數據。經調試發現,LookUpEdit 內部依賴 GridControl 模板部件,若 Name 不為 PART_GridControl,內部邏輯無法找到網格,導致綁定失效。
<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" 不可省略或改名。
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) |
AutoPopulateColumns | False 表示手動定義欄位,True 自動生成 |
IncrementalFiltering | 輸入時即時過濾 |
PopupOpening | 彈出前事件,適合動態載入數據 |
PART_GridControl。PopupOpening 事件中動態載入,避免啟動時效能負擔。get/set。DevExpress 控件功能強大但細節多,LookUpEdit 綁定實體類的核心在於 PART_GridControl 命名規範。掌握此點,即可順利實現下拉選擇與數據綁定。