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