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