In ColdFusion (2018 release), script functions implemented as CFCs are deprecated in ColdFusion.
Used to execute a stored procedure in a server database using CFScript. It specifies database connection information and identifies the stored procedure.
Mode |
Syntax |
|---|---|
Creating the service |
new storedProc() or createObject("component", "storedproc") |
Initializing the attributes |
Any one of the following:
|
Executing the service action |
storedProcService.execute(_attribute-value_pair_) |
datasource |
procedure |
debug |
cachedafter |
cachedwithin |
blockfactor |
password |
result |
returncode |
username |
|
|
All attributes supported by the tag cfstoredproc are supported as attribute-value pairs. For example,
<cfstoredproc procedure= "sp_proc"> |
can be used as
spService.setProcedure("sp_proc"); |
For details of the cfstoredproc tag attributes, see the Attributes section for cfstoredproc__.
cfstoredproc, Function summary
ColdFusion 9: Added this function.
addParam
Description |
Used to add cfprocparam tags. |
Syntax |
storedprocService.addParam(attribute-value pair) |
Returns |
Nothing |
Arguments |
All attributes supported by cfprocparam tag can be used as attribute-value pairs. |
addProcResult
Description |
Used to add cfprocresult tags to associate a query object with a result set returned by a stored procedure. |
Syntax |
storedprocService.addProcResult(attribute-value pair) |
Returns |
Nothing |
Arguments |
All attributes supported by the cfprocresult tag can be used as attribute-value pairs. |
execute
Description |
Used to execute a stored procedure. |
Returns |
A component on which the following methods can be invoked: |
getProcOutVariables(): To access OUT or INOUTvariables returned by the procedure.
Syntax |
storedprocService.execute(attribute-value pair) |
Arguments |
All attributes supported by the cfstoredproc tag. |
setAttributes
Description |
Sets attributes for the storedproc function. |
Returns |
Nothing |
Syntax |
storedProcService.setAttributes (attribute-value pair) |
Arguments |
All attributes supported by the cfstoredproc tag. |
getAttributes
Description |
Gets attributes that were set for the storedproc function. |
Returns |
Returns a struct with all or some of the attribute values. |
Syntax |
storedProcService.get_Attributes_ (attributelist) |
Arguments |
A comma-separated list of attributes. If no list is specified, all defined attributes are returned. |
clearAttributes
Description |
Removes all attributes added for the storedProc function. |
Returns |
Nothing |
Syntax |
storedProcService.clearAttributes(attribute_list) |
Arguments |
A comma-separated list of attributes. |
clearParams
Description |
Removes cfprocparam tags added using the addParam method. |
Returns |
Nothing |
Syntax |
storedProcService.clearParams() |
Arguments |
None |
clearProcResults
Description |
Removes cfprocresult tags added using the addProcResults method. |
Returns |
Nothing |
Syntax |
storedProcService.clearProcResults() |
Arguments |
None |
clear
Description |
Removes all attributes and params that were added using the methods addProcResults and addParam. |
Returns |
Nothing |
Syntax |
storedProcService.clear() |
Arguments |
None |
This function corresponds to the cfstoredproc tag. For usage details, refer to the Usage section for cfstoredproc.
<cfscript> |
Sign in to your account