ADO.NET Provider for Blackbaud Financial Edge NXT

Build 24.0.9060

Calling Stored Procedures

You can invoke a stored procedure using FinancialEdgeNXTCommand in the same way as any other SQL stored procedure. To instantiate a FinancialEdgeNXTCommand object, provide the name of the stored procedure and a FinancialEdgeNXTConnection instance as arguments to the constructor. Set the value of the CommandType property to "StoredProcedure" and add the parameters as key-value pairs to the Parameters collection of the FinancialEdgeNXTCommand instance.

C#

string connectionString = "InitiateOAuth=GETANDREFRESH;SubscriptionKey=MySubscriptionKey;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;";

using (FinancialEdgeNXTConnection connection = new FinancialEdgeNXTConnection(connectionString)) {
  FinancialEdgeNXTCommand cmd = new FinancialEdgeNXTCommand("SelectEntries", connection);
  cmd.CommandType = CommandType.StoredProcedure; 
  cmd.Parameters.Add(new FinancialEdgeNXTParameter("@ObjectName", "Account"));
  // Add other parameters as needed ...

  FinancialEdgeNXTDataReader rdr = cmd.ExecuteReader();
  while (rdr.Read()) {
    for (int i = 0; i < rdr.FieldCount; i++) {
      Console.WriteLine(rdr.GetName(i) + " --> " + rdr[i]);
    }
    Console.WriteLine();
  }
}

VB.NET

Dim connectionString As String = "InitiateOAuth=GETANDREFRESH;SubscriptionKey=MySubscriptionKey;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;"

Using connection As New FinancialEdgeNXTConnection(connectionString)
  Dim cmd As New FinancialEdgeNXTCommand("SelectEntries", connection)
  cmd.CommandType = CommandType.StoredProcedure
  cmd.Parameters.Add(New FinancialEdgeNXTParameter("@ObjectName", "Account"))
  ' Add other parameters as needed ...

  Dim rdr As FinancialEdgeNXTDataReader = cmd.ExecuteReader()
  While rdr.Read()
	  For i As Integer = 0 To rdr.FieldCount - 1
		  Console.WriteLine(rdr.GetName(i) + " --> " + rdr(i))
	  Next
	  Console.WriteLine()
  End While
End Using

Alternatively, you can set the parameters of a stored procedure in the text of the command. The support for stored procedure statements follows the standard form shown below:

"EXECUTE my_proc @first = 1, @second = 2, @third = 3;"

"EXEC my_proc @first = 1, @second = 2, @third = 3;"

To execute a parameterized query, add parameters as key-value pairs to the Parameters collection of the FinancialEdgeNXTCommand instance.

C#

string connectionString = "InitiateOAuth=GETANDREFRESH;SubscriptionKey=MySubscriptionKey;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;";

using (FinancialEdgeNXTConnection connection = new FinancialEdgeNXTConnection(connectionString)) {
  FinancialEdgeNXTCommand cmd = new FinancialEdgeNXTCommand("EXECUTE SelectEntries ObjectName = @ObjectName;", connection); 
  cmd.Parameters.Add(new FinancialEdgeNXTParameter("@ObjectName", "Account"));
  // Add other parameters as needed ...

  FinancialEdgeNXTDataReader rdr = cmd.ExecuteReader();
  while (rdr.Read()) {
    for (int i = 0; i < rdr.FieldCount; i++) {
      Console.WriteLine(rdr.GetName(i) + " --> " + rdr[i]);
    }
    Console.WriteLine();
  }
}

VB.NET

Dim connectionString As String = "InitiateOAuth=GETANDREFRESH;SubscriptionKey=MySubscriptionKey;OAuthClientId=MyOAuthClientId;OAuthClientSecret=MyOAuthClientSecret;CallbackURL=http://localhost:33333;"

Using connection As New FinancialEdgeNXTConnection(connectionString)
  Dim cmd As New FinancialEdgeNXTCommand("EXECUTE SelectEntries ObjectName = @ObjectName;", connection)
  cmd.Parameters.Add(New FinancialEdgeNXTParameter("@ObjectName", "Account"))
  ' Add other parameters as needed ...

  Dim rdr As FinancialEdgeNXTDataReader = cmd.ExecuteReader()
  While rdr.Read()
	  For i As Integer = 0 To rdr.FieldCount - 1
		  Console.WriteLine(rdr.GetName(i) + " --> " + rdr(i))
	  Next
	  Console.WriteLine()
  End While
End Using

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.9060