DataAdapter を使用したクエリ
CData ADO.NET Provider for Highrise では、次の2つのネイティブ.NET インターフェースを使用して、Highrise からデータを取得できます。HighriseDataAdapter オブジェクトおよびHighriseDataReader オブジェクト。各オブジェクトは同じタスク(データの取得)を実行しますが、実行方法が異なります。HighriseDataAdapter オブジェクトはクエリに一致するすべてのデータを取得しますが、HighriseDataReader オブジェクトは必要に応じてインクリメントしながら一部のデータだけをフェッチします。
HighriseDataAdapter の使用
アダプターのFill メソッドを使用して、データソースからデータを取得します。空のDataTable インスタンスがFill メソッドへの引数として渡されます。このメソッドが戻ってきたとき、DataTable インスタンスにはクエリされたデータが設定されています。Fill メソッドは、戻る前にデータソースからすべてのデータを取得する必要があるため、HighriseDataAdapter はHighriseDataReader よりも時間がかかります。
次の例は、People テーブルのId カラムとFirstname カラムを選択します。
C#
string connectionString = "InitiateOAuth=GETANDREFRESH;OAuthClientId=MyClientId;OAuthClientSecret=MyClientSecret;CallbackURL=http://localhost;AccountId=MyAccountId;"; using (HighriseConnection connection = new HighriseConnection(connectionString)) { HighriseDataAdapter dataAdapter = new HighriseDataAdapter( "SELECT Id, Firstname FROM People", connection); DataTable table = new DataTable(); dataAdapter.Fill(table); Console.WriteLine("Contents of People."); foreach (DataRow row in table.Rows) { Console.WriteLine("{0}: {1}", row["Id"], row["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 dataAdapter As New HighriseDataAdapter("SELECT Id, Firstname FROM People", connection) Dim table As New DataTable() dataAdapter.Fill(table) Console.WriteLine("Contents of People.") For Each row As DataRow In table.Rows Console.WriteLine("{0}: {1}", row("Id"), row("Firstname")) Next End Using