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 = "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 = "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