CData ADO.NET Provider for FreshBooks では、次の2つのネイティブ.NET インターフェースを使用して、FreshBooks からデータを取得できます。FreshBooksDataAdapter オブジェクトおよびFreshBooksDataReader オブジェクト。各オブジェクトは同じタスク（データの取得）を実行しますが、実行方法が異なります。FreshBooksDataAdapter オブジェクトはクエリに一致するすべてのデータを取得しますが、FreshBooksDataReader オブジェクトは必要に応じてインクリメントしながら一部のデータだけをフェッチします。

FreshBooksDataReader の使用

FreshBooksDataReader はページ単位でデータを取得できるため、FreshBooksDataAdapter よりもデータの取得が高速です。FreshBooksDataReader からデータを読み取っていくと、必要に応じて一定の間隔で、データソースからの結果の次のページが要求されます。このため、結果が高速に返されます。 次の例は、Clients テーブルからすべてのカラムを選択します。

C#

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

using (FreshBooksConnection connection = new FreshBooksConnection(connectionString)) {
  FreshBooksCommand cmd = new FreshBooksCommand("SELECT * FROM Clients", connection);
  
  FreshBooksDataReader rdr = cmd.ExecuteReader();

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

VB.NET

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

Using connection As New FreshBooksConnection(connectionString)
  Dim cmd As New FreshBooksCommand("SELECT * FROM Clients", connection)

  Dim rdr As FreshBooksDataReader = cmd.ExecuteReader()

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