DataGridView.GetItem(Int32) Method

Returns an object that represents a record in the grid’s underlying data source.

Namespace: DevExpress.XamarinForms.DataGrid

Assembly: DevExpress.XamarinForms.Grid.dll

NuGet Package: DevExpress.XamarinForms.Grid

Declaration

public object GetItem(
    int rowHandle
)

Parameters

Name	Type	Description
rowHandle	Int32	The row handle.

Returns

Type	Description
Object	An object that represents a data source record.

Remarks

The GetItem method returns an object that is an individual record in a grid’s underlying data source. For example, if a grid’s data source is a collection of Order objects, GetItem returns an Order object.

Example

This example shows how to set up the grid to display the Edit Values form when a user taps a cell. The grid is bound to a collection of orders.

1. Subscribe to the DataGridView.Tap event.

   XAML

   <dxg:DataGridView x:Name="grid" ItemsSource="{Binding Orders}" Tap="Grid_Tap">
       <dxg:DataGridView.Columns>
           <dxg:TextColumn FieldName="Product.Name" Caption="Product" />
           <dxg:NumberColumn FieldName="Product.UnitPrice" Caption="Price" DisplayFormat="C0"/>
           <dxg:NumberColumn FieldName="Quantity" />
           <dxg:NumberColumn FieldName="Total" 
                             UnboundType="Integer" UnboundExpression="[Quantity] * [Product.UnitPrice]" 
                             IsReadOnly="True" DisplayFormat="C0" />
           <dxg:DateColumn FieldName="Date" DisplayFormat="d" />
           <dxg:CheckBoxColumn FieldName="Shipped" />
       </dxg:DataGridView.Columns>
   </dxg:DataGridView>
   

2. In the event handler:

   1. Create an EditFormPage instance with the grid and data source’s record object to which the grid’s current row corresponds passed as constructor parameters.

   2. Call the Navigation.PushAsync method and pass the created page as a parameter.

      C#

      using Xamarin.Forms;
      using DevExpress.XamarinForms.DataGrid;
      
      namespace DataGridExample {
          public partial class MainPage : ContentPage {
              public MainPage() {
                  DevExpress.XamarinForms.DataGrid.Initializer.Init();
                  InitializeComponent();
              }
      
              private void Grid_Tap(object sender, DataGridGestureEventArgs e) {
                  if (e.Item != null) {
                      var editForm = new EditFormPage(grid, grid.GetItem(e.RowHandle));
                      Navigation.PushAsync(editForm);
                  }
              }
          }
      }
      

3. In the App.xaml.cs file, assign a NavigationPage instance to the Application.MainPage property and add the MainPage content page to the navigation stack (the application’s root page):

   C#

   namespace DataGridExample {
       public partial class App : Application {
           public App() {
               InitializeComponent();
   
               // MainPage = new MainPage();
               MainPage = new NavigationPage(new MainPage());
           }
   
           // ...
       }
   }
   

The grid now displays the Edit Values form when a user taps a data cell.

View Example