Execute a stored procedure via an IDbCommand (that returns a resultset) against the specified IDbTransaction using the provided parameter values. This method will query the database to discover the parameters for the stored procedure (the first time each stored procedure is called), and assign the values based on parameter order.

Namespace: CodeSmith.Engine
Assembly: CodeSmith.Engine (in CodeSmith.Engine.dll) Version: 6.0.0.0 (7.0.0.15127)

Syntax

C#
public virtual DataSet ExecuteDataset(
	IDbTransaction transaction,
	string spName,
	params Object[] parameterValues
)
Visual Basic
Public Overridable Function ExecuteDataset ( 
	transaction As IDbTransaction,
	spName As String,
	ParamArray parameterValues As Object()
) As DataSet

Parameters

transaction
Type: System.Data..::..IDbTransaction
A valid IDbTransaction
spName
Type: System..::..String
The name of the stored procedure
parameterValues
Type: array<System..::..Object>[]()[][]
An array of objects to be assigned as the input values of the stored procedure

Return Value

Type: DataSet
A DataSet containing the resultset generated by the command

Remarks

This method provides no access to output parameters or the stored procedure's return value parameter.

Examples

 Copy imageCopy
DataSet ds = helper.ExecuteDataset(tran, "GetOrders", 24, 36);

Exceptions

ExceptionCondition
System..::..ArgumentNullExceptionThrown if spName is null
System..::..ArgumentExceptionThrown if the parameter count does not match the number of values supplied
System..::..ArgumentNullExceptionThrown if transaction is null
System..::..ArgumentNullExceptionThrown if transaction.Connection is null

See Also