Quick Start: Populating AutoComplete with Data
ComponentOne Xamarin Edition
Quick Start: Populating AutoComplete with Data
Controls > Input > AutoComplete > Quick Start: Populating AutoComplete with Data

This section describes adding the AutoComplete control to your portable or shared application and displaying a list of items in the drop-down as suggestions for users.

Complete the following steps to display an AutoComplete control.

The following image shows how the AutoComplete control provides a list of suggestions in a drop-down list when the user enters text.

Step 1: Add a list of pre-defined suggestions

Complete the following steps to add a list of items to be displayed in the drop-down list.

  1. Create a new portable or shared Xamarin.Forms application (Refer Creating a New Xamarin.Forms App for detailed instructions).
  2. Add a new class (say Country.cs) to your application.
  3. Add the following code to initialize a collection of items (here, a list of major countries).
    C#
    Copy Code
    public class Country
        {
            public override string ToString()
            {
                return Name;
            }
    
            public static readonly string[] Countries = { "Germany", "Japan", "Australia",
                "Bangladesh", "Brazil", "Canada", "China", "France", "India", "Nepal",
                "Pakistan", "Srilanka" };
            public string Name { get; set; }
            public static ObservableCollection<Country> GetCountries()
            {
                ObservableCollection<Country> listContries = new ObservableCollection<Country>();
    
                foreach (var item in Countries)
                {
                    listContries.Add(new Country() { Name = item });
                }
                return listContries;
            }
        }

Step 2: Add AutoComplete control and populate it with suggestions

  1. Add a new Content Page (say Page1.xaml) to your application.
  2. Edit the <ContentPage> tag to include the following reference.
    XAML
    Copy Code
    xmlns:c1="clr-namespace:C1.Xamarin.Forms.Input;assembly=C1.Xamarin.Forms.Input"
  3. Initialize an editable AutoComplete control and set some of its basic properties such as Name, DisplayMemberPath, etc. by adding the given markup between <StackLayout></StackLayout> tags inside the <ContentPage></ContentPage> tags.
    XAML
    Copy Code
    <StackLayout Orientation="Vertical">
        <c1:C1AutoComplete x:Name="autoComplete" ItemsSource="{Binding ItemsSource}" DisplayMemberPath="Name"
            HorizontalOptions="FillAndExpand" VerticalOptions="Start"></c1:C1AutoComplete>
      </StackLayout>
  4. Expand the Page1.xaml node in the Solution Explorer to open Page1.xaml.cs and add the given code in the constructor to set ItemsSource property of the AutoComplete control.
    C#
    Copy Code
    autoComplete.ItemsSource = Country.GetCountries();

Step 3: Run the Project

  1. In the Solution Explorer, double-click App.cs file to open it.
  2. To return a Content Page, set the MainPage to Page1 in the constructor App() as illustrated in the given code
    C#
    Copy Code
    public App()
       {
           // The root page of your application
           MainPage = new Page1();
       }
  3. Some additional steps are required to run iOS and UWP apps:
    • iOS App:
      1. In the Solution Explorer, double click AppDelegate.cs inside YourAppName.iOS project to open it.
      2. Add the following code to the FinishedLaunching() method.
        C#
        Copy Code
        C1.Xamarin.Forms.Input.Platform.iOS.C1InputRenderer.Init();
    • UWP App:
      1. In the Solution Explorer, expand the MainPage.xaml inside YouAppName.UWP project.
      2. Double click the MainPage.xaml.cs to open it and add the following code to the class constructor.
        C#
        Copy Code
        C1.Xamarin.Forms.Input.Platform.UWP.C1InputRenderer.Init();
      3. (Optional) In case you compile your UWP application in Release mode, you need to explicitly add the following code to the OnLaunched method in your App.xaml.cs to include the correct assemblies with your application.

        C#
        Copy Code
        var assembliesToInclude = new List<Assembly>();
        assembliesToInclude.Add(typeof(C1.Xamarin.Forms.Input.Platform.UWP.C1InputRenderer)
        .GetTypeInfo().Assembly);
        assembliesToInclude.Add(typeof(C1.UWP.Input.C1InputRenderer).GetTypeInfo().Assembly);
        Xamarin.Forms.Forms.Init(e, assembliesToInclude);
  4. Press F5 to run the project.