Binding to Collections of Primitive Types (xamComboEditor)

Topic Overview

Purpose

This topic describes the specifics when the xamComboEditor™ control is bound to a collection of primitive type data.

In this topic

This topic contains the following sections:

Supported Types
Working with xamComboEditor Bound to a Collection of Primitive Type
Related Topics

Supported Types

Supported types summary chart

We refer to the following types as a primitive type data supported by the xamComboEditor control:

Data Type	Details	Types
Primitives	The `Type` `IsPrimitive` property returns `true` for this particular type – e.g. `typeof(int).IsPrimitive`	Boolean Char Byte, SByte, Int16, UInt16, Int32, UInt32, Int64, UInt64, IntPtr, UIntPtr Double and Single
DateTime Structure	Represents an instant in time.	DateTime
Enumeration	Consists of a set of named constants called the enumerator list.	enum
string	Represents a sequence of zero or more Unicode characters.	string

Working with xamComboEditor Bound to a Collection of Primitive Type Data

Supported key features summary chart

The following table summarizes briefly the key features of the xamComboEditor control and which of them are supported when the control is bound to a collection of a primitive type data. Further details are available after the table.

Feature	Data Type	Supported
Auto Complete	Primitives	Yes
	DateTime Structure	Yes
	Enumeration	Yes
	string	Yes
Custom Value Entered Action	Primitives	Yes
	DateTime Structure	Yes
	Enumeration	Yes
	string	Yes
Selection	Primitives	Yes
	DateTime Structure	Yes
	Enumeration	Yes
	string	Yes
Custom Filtering	Primitives	See the details below
	DateTime Structure	Yes
	Enumeration	See the details below
	string	Yes

General

When the xamComboEditor is bound to a collection of primitive type data, the DisplayMemberPath property should not be set. If it is set, an ArgumentException is thrown.

Auto Complete

Auto complete feature is completely supported when the xamComboEditor is bound to a collection of primitive type data.

Custom Value Entered Action

Different options for custom value entered action – Add, Allow and Ignore are supported when the xamComboEditor is bound to a collection of primitive type data.

When the CustomValueEnteredAction is set to Add, the DataObjectRequested event is not fired.

Selection

Selection is supported when the xamComboEditor is bound to a collection of primitive type data.

Note	Note The xamComboEditor SelectedValue and SelectedValues properties return always `null` because they depend on the SelectedValuePath property which expects a complex data type property. In the case of a collection of primitive type data, the `SelectedValuePath` property should remain unset.

Custom Filtering

Custom filtering is supported when the xamComboEditor is bound to a collection of primitive type data. The ComboItemFilter FieldName should remain unset.

Note	Note For collection of `bool` or `enum`, the only applicable ComparisonCondition Operator -s are Equals and NotEquals.

Topic	Purpose
About xamComboEditor	This topic lists the xamComboEditor control key features.
Adding xamComboEditor to Your Page	This topic describes how to get started with the xamComboEditor control and how to add it to your page using procedural code.
Configuring xamComboEditor	The topics in this group explain the main features of the xamComboEditor control, their use and configuration.

WPF | Help Topics