dotConnect for Adobe Commerce Documentation
Devart.Common Namespace / DbCommandBase Class / ExecutePageReader Method
One of the System.Data.CommandBehavior values.
Zero-based ordinal of row that result set starts with.
Quantity of rows in result set.
Example

In This Topic
    ExecutePageReader Method
    In This Topic
    Returns a specific subset of rows when paging through the results of a query.
    Syntax
    'Declaration
     
    Public Function ExecutePageReader( _
       ByVal behavior As CommandBehavior, _
       ByVal startRecord As Integer, _
       ByVal maxRecords As Integer _
    ) As DbDataReader
    public DbDataReader ExecutePageReader( 
       CommandBehavior behavior,
       int startRecord,
       int maxRecords
    )

    Parameters

    behavior
    One of the System.Data.CommandBehavior values.
    startRecord
    Zero-based ordinal of row that result set starts with.
    maxRecords
    Quantity of rows in result set.

    Return Value

    Remarks

    Use method ExecutePageReader when you want to retrieve not the whole dataset but some part of it that begins with given row number and has certain quantity of rows. This is especially useful when working with large amounts of data.

    If you want to retrieve all data in a dataset, use System.Data.Common.DbCommandBase.ExecuteReader() instead.

    Example
    The example below shows how to retrieve a part of a table. If this function is called with parameters startRecord=2 and maxRecords=3, it returns 3 rows: second, third, and fourth.
    public void ExecutePaged(MagentoConnection adobe commerceConnection, int StartRow, int PageLength)
    {
      MagentoCommand adobe commerceCommand = new MagentoCommand("SELECT customer_id, firstname, lastname FROM Customers", adobe commerceConnection);
      adobe commerceConnection.Open();
      MagentoDataReader adobe commerceReader = adobe commerceCommand.ExecutePageReader(System.Data.CommandBehavior.Default,StartRow,PageLength);
      try
      {
        while (adobe commerceReader.Read())
        {
            Console.WriteLine(adobe commerceReader.GetInt32(0).ToString() + ", " + adobe commerceReader.GetString(1) + ", " + adobe commerceReader.GetString(2));
        }
      }
      finally
      {
        adobe commerceReader.Close();
        adobe commerceConnection.Close();
      }
    }
    Public Sub ExecutePaged(ByVal adobe commerceConnection As MagentoConnection, ByVal StartRow As Integer, ByVal PageLength As Integer)
      Dim adobe commerceCommand As New MagentoCommand("SELECT customer_id, firstname, lastname FROM Customers", adobe commerceConnection)
      adobe commerceConnection.Open()
      Dim adobe commerceReader As MagentoDataReader = adobe commerceCommand.ExecutePageReader(System.Data.CommandBehavior.Default, StartRow, PageLength)
      Try
        While adobe commerceReader.Read()
          Console.WriteLine(adobe commerceReader.GetInt32(0).ToString() + ", " _
          + adobe commerceReader.GetString(1) + ", " _
          + adobe commerceReader.GetString(2))
        End While
      Finally
        adobe commerceReader.Close()
        adobe commerceConnection.Close()
      End Try
    End Sub
    See Also