The CData ADO.NET Provider for Highrise implements two ADO.NET interfaces you can use to retrieve data from Highrise: HighriseDataAdapter and HighriseDataReader objects. Whereas HighriseDataAdapter objects retrieve a single result set of all the data that matches a query, HighriseDataReader objects fetch data in subset increments as needed.

Using the HighriseDataReader

The HighriseDataReader retrieves data faster than the HighriseDataAdapter because it can retrieve data in pages. As you read data from the HighriseDataReader, it periodically requests the next page of results from the data source, if required. This causes results to be returned at a faster rate. The following example selects all the columns from the People table:

C#

string connectionString = "InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;CallbackURL=http://localhost;AccountId=MyAccountId;";

using (HighriseConnection connection = new HighriseConnection(connectionString)) {
  HighriseCommand cmd = new HighriseCommand("SELECT * FROM People", connection);
  
  HighriseDataReader rdr = cmd.ExecuteReader();

  while (rdr.Read()) {
    Console.WriteLine(String.Format("\t{0} --> \t\t{1}", rdr["Id"], rdr["Firstname"]));
  }
}

VB.NET

Dim connectionString As String = "InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;CallbackURL=http://localhost;AccountId=MyAccountId;"

Using connection As New HighriseConnection(connectionString)
  Dim cmd As New HighriseCommand("SELECT * FROM People", connection)

  Dim rdr As HighriseDataReader = cmd.ExecuteReader()

  While rdr.Read()
    Console.WriteLine([String].Format(vbTab & "{0} --> " & vbTab & vbTab & "{1}", rdr("Id"), rdr("Firstname")))
  End While
End Using