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