Add Data Grid to Xamarin.Forms Solution

• Aug 20, 2021
• 3 minutes to read

This topic explains how to integrate the DevExpress Data Grid component into a Xamarin.Forms cross-platform solution.

Important

The DevExpress Data Grid for Xamarin.Forms component is available for iOS and Android platforms, and can be used in Xamarin.Forms solutions that use the .NET Standard code sharing strategy.

For the Android project, the Target Framework and Target Android version should be Android 10 (API level 29) or later.

1. Add the DevExpress Data Grid component to your solution in one of the following ways:

   • Install the NuGet package

     Visual Studio

     1. Obtain your NuGet feed URL

     2. Register the DevExpress NuGet feed as a package source.
        Navigate to Tools | Options | NuGet Package Manager | Package Source and add the DevExpress feed to the list of package sources.

        

     3. Install the DevExpress.XamarinForms.Grid package from the DevExpress NuGet feed.

        1. Select Tools | NuGet Package Manager | Manage NuGet Packages for Solution… in Visual Studio’s main menu, or right-click the solution in Solution Explorer and select Manage NuGet Packages for Solution….

        2. Search for DevExpress.XamarinForms.Grid in the DevExpress package source, select all the solution’s projects and click Install.

           

     Visual Studio for Mac

     1. Obtain your NuGet feed URL

     2. Register the DevExpress NuGet feed as a package source.
        Navigate to Visual Studio | Preferences | NuGet | Sources and add the DevExpress feed to the list of sources.

        

     3. Install the DevExpress.XamarinForms.Grid package from the DevExpress NuGet feed.

        1. Select Project | Manage NuGet Packages… in the main menu, or right-click the solution in Solution Pad and select Manage NuGet Packages…

        2. In the invoked Manage NuGet Packages dialog, select DevExpress from the Source drop-down list in the top left corner, search for DevExpress.XamarinForms.Grid and click Add Package.
           Select all the solution’s projects in the invoked Select Projects dialog and click Ok.

           

     – or –

   • Add libraries from the downloaded bundle

     1. Add the Xamarin.Kotlin.StdLib NuGet package to the Android project of your Xamarin.Forms solution.
     2. Download the Mobile UI Controls for Xamarin.Forms bundle from the Client Center.

     3. Add the following assembly references to your Xamarin.Forms solution’s projects:

        Project	Assembly
        <YourAppName> (A .NET Standard project that contains the shared code)	DevExpress.XamarinForms.Core.dll DevExpress.XamarinForms.Grid.dll DevExpress.XamarinForms.Editors
        <YourAppName>.Android (A project that contains Android-specific code)	DevExpress.Xamarin.Android.Grid.dll DevExpress.XamarinForms.Grid.Android.dll DevExpress.XamarinForms.Editors.Android
        <YourAppName>.iOS (A project that contains iOS-specific code)	DevExpress.Xamarin.iOS.Grid.dll DevExpress.XamarinForms.Grid.iOS.dll DevExpress.XamarinForms.Editors.iOS

        Note

        These files are in the <DevExpress.Xamarin bundle>/Binaries directory. Ensure the downloaded <DevExpress.Xamarin> bundle was unzipped.

2. Select the d8 Dex compiler to build the Android project.

   Visual Studio

   Right-click the Android project and select Properties.

   

   Visual Studio for Mac

   Right-click the Android project and select Options.

   

3. Add the initialization code to your projects.

   • In the AppDelegate.cs file of the iOS project, before the LoadApplication method call:

     C#

     DevExpress.XamarinForms.DataGrid.iOS.Initializer.Init();
     

   • In the App.xaml.cs file of the project with the shared code, before the InitializeComponent method call:

     C#

     DevExpress.XamarinForms.DataGrid.Initializer.Init();
     

4. Add the following namespace to the XAML markup or C# file in which you create a grid:

   XAML

   xmlns:dxg="http://schemas.devexpress.com/xamarin/2014/forms/datagrid"
   

   C#

   using DevExpress.XamarinForms.DataGrid;
   

5. Create a DataGridView instance in XAML markup or C# code:

   XAML

   <ContentPage 
       xmlns="http://xamarin.com/schemas/2014/forms"
       xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
       xmlns:local="clr-namespace:DataGridExample"
       x:Class="DataGridExample.MainPage"
       xmlns:dxg="http://schemas.devexpress.com/xamarin/2014/forms/datagrid">
   
       <dxg:DataGridView x:Name="grid">
       </dxg:DataGridView>
   </ContentPage>
   

   C#

   using System;
   using Xamarin.Forms;
   using DevExpress.XamarinForms.DataGrid;
   
   namespace DataGridExample {
       public class App : Application {
           public App () {
               DataGridView grid = new DataGridView();
               MainPage = new ContentPage {
                   Content = grid,
               };
           }
       }
   }
   

The following section contains examples with instructions on how to bind a grid to a data source, specify grid columns, and manage data: Getting Started.