DataSourceSelectArguments.StartRowIndex Property

Definition

Gets or sets a value that represents the starting position the data source control should use when retrieving data rows during a data retrieval operation.

public:
 property int StartRowIndex { int get(); void set(int value); };
public int StartRowIndex { get; set; }
member this.StartRowIndex : int with get, set
Public Property StartRowIndex As Integer

Property Value

The starting row position from which a data source control retrieves data. The default value is 0, which indicates that the starting position is the beginning of the result set.

Remarks

The StartRowIndex property supports paging scenarios. Data-bound controls check a data source view's CanPage property at run time, and add a DataSourceCapabilities.Page capability using the AddSupportedCapabilities(DataSourceCapabilities) method if the view supports paging. If the data-bound control fails to add the capability, and the paging properties are set on a DataSourceSelectArguments object passed to the data source view during a data retrieval operation, an InvalidOperationException exception might be thrown.

As a separate operation, the data-bound control can request a subset of data from a data source control by setting the StartRowIndex and MaximumRows properties on the DataSourceSelectArguments object passed to the DataSourceView.Select(DataSourceSelectArguments, DataSourceViewSelectCallback) method.

Applies to

See also