DataControlBase.FindRowByValue(String, Object) Method

Searches for the value in the column and returns the handle of the corresponding row. This is a dependency property.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v18.2.Core.dll

Declaration

C#

public int FindRowByValue(
    string fieldName,
    object value
)

VB.NET

Public Function FindRowByValue(
    fieldName As String,
    value As Object
) As Integer

Parameters

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.

Returns

Type	Description
Int32	An integer value that is the handle of the corresponding row.

Remarks

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.

To learn more, see Obtaining Row Handles.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the FindRowByValue(String, Object) method.

Note

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.

C#

how-to-create-checkable-grouping-in-gridcontrol-t127563/CS/DevExpress.Example03/CheckableGroupBehavior.cs#L155

foreach(var item in this.AssociatedObject.ItemsSource as IEnumerable<object>) {
    int handle = this.AssociatedObject.FindRowByValue("", item);
    result.Add(handle);

how-to-preserve-the-dxgrid-for-wpf-view-state-e4222/CS/SaveWpfGridState/RowStateHelper.cs#L269

int GetRowHandleByKey(object key, GridControl grid) {
    return grid.FindRowByValue(keyFieldName, key);
}

VB.NET

how-to-create-checkable-grouping-in-gridcontrol-t127563/VB/DevExpress.Example03/CheckableGroupBehavior.vb#L170

For Each item In TryCast(Me.AssociatedObject.ItemsSource, IEnumerable(Of Object))
    Dim handle As Integer = Me.AssociatedObject.FindRowByValue("", item)
    result.Add(handle)

how-to-preserve-the-dxgrid-for-wpf-view-state-e4222/VB/SaveWpfGridState/RowStateHelper.vb#L295

Private Function GetRowHandleByKey(ByVal key As Object, ByVal grid As GridControl) As Integer
    Return grid.FindRowByValue(keyFieldName, key)
End Function