Skip to main content

DataControlBase.FindRowByValue(String, Object) Method

Searches for the value in the column and returns the handle of the corresponding row.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v23.1.Core.dll

NuGet Package: DevExpress.Wpf.Grid.Core


public int FindRowByValue(
    string fieldName,
    object value


Name Type Description
fieldName String

A String value that specifies the field name of the column to be searched.

value Object

An object that is the search value.


Type Description

An integer value that is the handle of the corresponding row.


If the value is not found, the FindRowByValue method returns DataControlBase.InvalidRowHandle.

If the column contains more than one search value, the FindRowByValue method returns the handle of the first corresponding row.

If the first parameter is set to String.Empty, the FindRowByValue method searches using the whole row value.

Refer to the following help topic for more information: Obtain Row Handles.


This example shows how to identify a data cell with the specified value and focus it. To do this, click the Focus Cell button.

Grid - Focus a Row with the Specified Value

View Example: Focus a Cell with the Specified Value

        <RowDefinition Height="Auto"/>
    <dxg:GridControl Name="grid" AutoGenerateColumns="AddNew">
            <dxg:TableView x:Name="view" AutoWidth="True" FadeSelectionOnLostFocus="False"/>
    <StackPanel Grid.Row="1" Orientation="Horizontal">
        <TextBlock Text="Unit Price:" TextAlignment="Right" Padding="4"/>
        <TextBox x:Name="textBox" Width="50" Margin="0,0,5,0" HorizontalAlignment="Left"/>
        <Button  Content="Focus Cell" HorizontalAlignment="Left" Click="FocusCell"/>
void FocusCell(object sender, RoutedEventArgs e) {
    if (!double.TryParse(textBox.Text, out double textValue))
    var rowHandle = grid.FindRowByValue(grid.Columns[nameof(Product.UnitPrice)], textValue);
    if (rowHandle == DataControlBase.InvalidRowHandle) 
    grid.CurrentColumn = grid.Columns[nameof(Product.UnitPrice)];
    view.FocusedRowHandle = rowHandle;

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the FindRowByValue(String, Object) method.


The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also