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