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