LookUpEditBase.ValueMember Property

Gets or sets a field name in the bound data source, whose values are assigned to item values. This is a dependency property.

Namespace: DevExpress.Xpf.Editors

Assembly: DevExpress.Xpf.Core.v24.2.dll

NuGet Package: DevExpress.Wpf.Core

Declaration

C#

[DefaultValue("")]
public string ValueMember { get; set; }

VB.NET

<DefaultValue("")>
Public Property ValueMember As String

Property Value

Type	Default	Description
String	String.Empty	A String value that specifies the field name in a bound data source.

Remarks

To bind the editor to a data source, use its LookUpEditBase.ItemsSource property. The LookUpEditBase.DisplayMember and LookUpEditBase.ValueMember properties specify the field names in a data source that supply display strings and item values, respectively.

Note

The ValueMember property should refer to a data property that contains unique values.

If the ValueMember property is not specified, the editor’s BaseEdit.EditValue property returns the entire data object that corresponds to the selected item.

Note

When the DisplayMember and ValueMember properties are specified, the ComboBoxEdit allows users to enter only the values from its ItemsSource.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ValueMember property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

wpf-data-grid-implement-crud-operations/CS/CodeBehind/EFCore/ServerMode/IssueDetailView.xaml#L13

<dxe:ComboBoxEdit EditValue="{Binding Item.UserId}" ItemsSource="{Binding EditOperationContext.Users}"
                  ValueMember="Id" DisplayMember="Name"
                  IsTextEditable="False" />

wpf-synchronous-theme-preload-with-splashscreen/CS/ThemePreloadwithSplashscreen/ComplexWindow.xaml#L96

                                          AllowImages=False}"
        ValueMember="Value" />
</dxlc:LayoutItem>

wpf-gridcontrol-populate-inplace-comboboxedit-with-values-based-on-values-from-other-cells/CS/MainWindow.xaml#L30

                  Name="PART_Editor"
                  ValueMember="Color"/>
<DataTemplate.Triggers>

wpf-use-devexpress-theme-in-applications/CS/DevExpress.Examples.ThemeSwitcher/MainWindow.xaml#L22

<dxe:ComboBoxEdit VerticalAlignment="Center" Width="200" ItemsSource="{Binding Source={x:Static dx:Theme.Themes}}" x:Name="cbTheme"
                  DisplayMember="Name" ValueMember="Name" EditValueChanged="cbTheme_EditValueChanged" />

wpf-lookupedit-process-new-values/CS/HowToCreateLookUpEdit/MainWindow.xaml#L34

DisplayMember="ProductName"
ValueMember="ID"
AddNewButtonPlacement="Popup"