Migrating from Xamarin SfAutoComplete to .NET MAUI SfAutocomplete

15 Jul 20241 minute to read

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

Namespaces

Xamarin SfAutoComplete .NET MAUI SfAutocomplete
Syncfusion.SfAutoComplete.XForms Syncfusion.Maui.Inputs

Properties

Xamarin SfAutoComplete .NET MAUI SfAutocomplete Description

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


AutoCompleteMode

TextSearchMode

Gets or sets the search mode of the control. The enum values are "StartsWith" and "Contains".
When using StartsWith, the AutoCompleteMode will be set to Append.
When using Contains, the AutoCompleteMode will be set to Suggest.

ItemsSource

,

DataSource

,

AutoCompleteSource

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 SfAutoComplete .NET MAUI SfAutocomplete 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 SfAutocomplete control.

Events

Event Name Xamarin SfAutoComplete .NET MAUI SfAutocomplete Description

SelectionChanged

SelectionChangedEventArgs


SelectionChangedEventArgs


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