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