DataReader を使用したクエリ
CData ADO.NET Provider for Blackbaud Raisers Edge NXT では、次の2つのネイティブ.NET インターフェースを使用して、BlackBaud Raiser's Edge NXT からデータを取得できます。RaiserEdgeNXTDataAdapter オブジェクトおよびRaiserEdgeNXTDataReader オブジェクト。各オブジェクトは同じタスク(データの取得)を実行しますが、実行方法が異なります。RaiserEdgeNXTDataAdapter オブジェクトはクエリに一致するすべてのデータを取得しますが、RaiserEdgeNXTDataReader オブジェクトは必要に応じてインクリメントしながら一部のデータだけをフェッチします。
RaiserEdgeNXTDataReader の使用
RaiserEdgeNXTDataReader はページ単位でデータを取得できるため、RaiserEdgeNXTDataAdapter よりもデータの取得が高速です。RaiserEdgeNXTDataReader からデータを読み取っていくと、必要に応じて一定の間隔で、データソースからの結果の次のページが要求されます。このため、結果が高速に返されます。 次の例は、Constituents テーブルからすべてのカラムを選択します。
C#
string connectionString = "InitiateOAuth=GETANDREFRESH;SubscriptionKey=MySubscriptionKey;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;"; using (RaiserEdgeNXTConnection connection = new RaiserEdgeNXTConnection(connectionString)) { RaiserEdgeNXTCommand cmd = new RaiserEdgeNXTCommand("SELECT * FROM Constituents", connection); RaiserEdgeNXTDataReader rdr = cmd.ExecuteReader(); while (rdr.Read()) { Console.WriteLine(String.Format("\t{0} --> \t\t{1}", rdr["Id"], rdr["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 cmd As New RaiserEdgeNXTCommand("SELECT * FROM Constituents", connection) Dim rdr As RaiserEdgeNXTDataReader = cmd.ExecuteReader() While rdr.Read() Console.WriteLine([String].Format(vbTab & "{0} --> " & vbTab & vbTab & "{1}", rdr("Id"), rdr("AddressLines"))) End While End Using