Migrating from Xamarin ComboBox to .NET MAUI ComboBox

18 Nov 20181 minute to read

To migrate easier from Xamarin ComboBox to .NET Maui ComboBox, we kept most of the APIs from Xamarin ComboBox in .NET Maui ComboBox. However, to maintain the consistency of API naming in .NET Maui ComboBox, we renamed some of the APIs. The APIs that have been changed in .NET Maui ComboBox from Xamarin ComboBox are detailed as follows.

Namespaces

Xamarin ComboBox	.NET MAUI ComboBox
Syncfusion.XForms.ComboBox	Syncfusion.Maui.Inputs

Properties

</tr>

Xamarin ComboBox	.NET MAUI ComboBox	Description
IsEditableMode	IsEditable	Gets or sets whether the textbox can support editing.
Watermark	Placeholder	Gets or sets the place holder text.
WatermarkColor	PlaceholderColor	Gets or sets the color of the place holder text.
ClearButtonColor	ClearButtonIconColor	Gets or sets the color of the clear button.
ShowClearButton	IsClearButtonVisible	Gets or sets whether to show the clear button.
MaximumDropDownHeight	MaxDropDownHeight	Gets or sets the maximum dropdown height.
SuggestionMode ComboBoxMode	TextSearchMode	Gets or sets the search mode of the control. The enum values are "StartsWith" and "Contains". When using StartsWith, the ComboBoxMode will be set to Append. When using Contains, the ComboBoxMode will be set to Suggest.
ItemsSource , DataSource , ComboBoxSource	ItemsSource	Gets or sets the data to be populated in the control.
Delimiter	DelimiterText	Gets or sets a string as delimiter which is displayed between the selected items in multiple selection mode.
NoResultsFoundFontAttributes , NoResultsFoundFontFamily , NoResultsFoundFontSize , NoResultsFoundTextColor	NoResultsFoundTemplate	Gets or sets the DataTemplate used to display in the dropdown when no results are found in the search.

Enums

Enum	Xamarin ComboBox	.NET MAUI ComboBox	Description
Xamarin - SuggestionMode .NET MAUI - TextSearchMode	StartsWith , StartsWithCaseSensitive , Contains , ContainsWithCaseSensitive , Equals , EqualsWithCaseSensitive , EndsWith , EndsWithCaseSensitive , Custom	StartsWith , Contains .	Gets or sets the search mode of the control.
Xamarin - SuggestionBoxPlacement .NET MAUI - DropDownPlacement	Auto , Bottom , None , Top	Auto , Bottom , None , Top	Gets or sets the position of the drop-down.
Xamarin - MultiSelectMode .NET MAUI - MultiSelectionDisplayMode	Delimiter , None , Token	Delimiter , Token	Gets or sets the multi selection mode for the ComboBox control.

Events

Event Name	Xamarin ComboBox	.NET MAUI ComboBox	Description
SelectedChanged	SelectionChangedEventArgs Value	SelectionChangedEventArgs PreviousSelection CurrentSelection	Raises when an item is selected in the dropdown or the SelectedItem is set programmatically.Returns the previous selected item and the currently selected item

Upcoming features

• Diacritic Sensitivity