Migrating from Xamarin SfComboBox to .NET MAUI SfComboBox

15 Nov 20221 minute to read

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

Namespaces

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

Properties

Xamarin SfComboBox .NET MAUI SfComboBox 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.

Enums

Enum Xamarin SfComboBox .NET MAUI SfComboBox Description
Xamarin -

SuggestionMode


.NET MAUI -

[TextSearchMode]https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.SfComboBox.html#Syncfusion_Maui_Inputs_SfComboBox_TextSearchMode)

StartsWith

,

StartsWithCaseSensitive

,

Contains

,

ContainsWithCaseSensitive

,

Equals

,

EqualsWithCaseSensitive

,

EndsWith

,

EndsWithCaseSensitive

,

Custom

StartsWith

,

Contains

.		 Gets or sets the search mode of the control.

Events

Event Name Xamarin SfComboBox .NET MAUI SfComboBox Description

SelectedChanged

SelectionChangedEventArgs

SelectionChangedEventArgs


 Raises when an item is selected in the dropdown or the SelectedItem is set programatically.Returns the previous selected item and the currently selected item

Upcoming features

  • Item Template
  • Multiple Selection with Tokens and Delimiter
  • Diacritic Sensitivity
  • Header and Footer
  • Highlighting Text
  • Load More Feature
  • Minimum Prefix Character
  • Customizations in Drop-Down