ExecutePageReader Method (SQLiteCommand)

In This Topic

Returns a specific subset of rows when paging through the results of a query.

Syntax

Visual Basic
C#

'Declaration
 
Public Shadows Function ExecutePageReader( _
   ByVal behavior As CommandBehavior, _
   ByVal startRecord As Integer, _
   ByVal maxRecords As Integer _
) As SQLiteDataReader

public new SQLiteDataReader ExecutePageReader( 
   CommandBehavior behavior,
   int startRecord,
   int maxRecords
)

Parameters

behavior: One of the System.Data.CommandBehavior values.
startRecord: Specifies the number of starting record of the set of records to be returned.
maxRecords: Specifies total number of records to retrieve.

Return Value

A SQLiteDataReader object with requested records.

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 ExecuteReader() instead.

Note: This method is not supported in .NET Standard 1.3 compatible assembly. It is available only in the assembly for full .NET Framework and .NET Standard 2.0 compatible assembly.

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.

csharp

public void ExecutePaged(SQLiteConnection sqConnection, int StartRow, int PageLength)
{
  SQLiteCommand sqCommand = new SQLiteCommand("SELECT * FROM Dept", sqConnection);
  sqConnection.Open();
  SQLiteDataReader sqReader = sqCommand.ExecutePageReader(System.Data.CommandBehavior.Default,StartRow,PageLength);
  try
  {
    while (sqReader.Read())
    {
      Console.WriteLine(sqReader.GetInt32(0) + ", " + sqReader.GetString(1) + ", " + sqReader.GetString(2));
    }
  }
  finally
  {
    sqReader.Close();
    sqConnection.Close();
  }
}

Visual Basic

Public Sub ExecutePaged(ByVal sqConnection As SQLiteConnection, ByVal StartRow As Integer, ByVal PageLength As Integer)
  Dim sqCommand As New SQLiteCommand("SELECT * FROM Dept", sqConnection)
  sqConnection.Open()
  Dim sqReader As SQLiteDataReader = sqCommand.ExecutePageReader(System.Data.CommandBehavior.Default, StartRow, PageLength)
  Try
    While sqReader.Read()
      Console.WriteLine(sqReader.GetInt32(0).ToString() + ", " _
      + sqReader.GetString(1) + ", " _
      + sqReader.GetString(2))
    End While
  Finally
    sqReader.Close()
    sqConnection.Close()
  End Try
End Sub

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

SQLiteCommand Class
SQLiteCommand Members
ExecuteReader() Method

Send Feedback