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