ColdFusion Developer's Guide

Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta
The showName.cfm action page has the following code:
The Name is : #Form.name#
In this example, when you enter a name in the text input and click the Enter name button,
the entered text replaces the form on the page, but the rest of the page is not refreshed.
Using the cfajaxproxy SetForm function
The SetForm function of the proxy object created by the cfajaxproxy tag passes the form
values as arguments to the next CFC function proxy that you call after the SetForm function.
This way, you can pass the current values of fields in a form to a CFC, which can then do the
necessary processing and return a result.
When you use the SetForm function, the following rules apply to the arguments in the called
CFC function:
■ The function does not need to specify the form fields in cfargument tags, and the
function still gets the field values passed by name.
■ Form fields which have the same names as CFC arguments will override any values passed
to the CFC argument from the proxy function call.
■ If you do not specify form fields in the in cfargument tags, They do not necessarily
immediately follow any declared arguments when you use positional (array) notation to
access them in the arguments structure.
■ The arguments scope in the CFC function includes two fields that ColdFusion uses to
control its behavior. These fields are intended for internal use, and their names might
change in future releases. Both field values are set to true:
■ _CF_NODEBUG tells ColdFusion not to return debugging output in the call response.
■ _CF_NOCACHE tells ColdFusion send a no cache header on the response, which
prevents the browser from caching the response and ensures that every AJAX request
results in a network call.
Using AJAX form controls and features 901