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