Adobe 38043740 Developing Applications - Page 826

DEVELOPING COLDFUSION 9 APPLICATIONS 821 Requesting and Presenting Information This area is not refreshed when the form is submitted. This form is replaced by the action page In the following 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. This example shows the showName.cfm action page: The Name is : #Form.name# Using the cfajaxproxy SetForm function The SetForm function of the proxy object created by the cfajaxproxy tag causes the proxy to pass the form values as arguments to the next CFC function that you call after the SetForm function. This way, you can pass the current values of fields in a form to a CFC function, 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 gets the field values passed by name. • Form fields that have the same names as CFC arguments override the CFC argument values. • If you do not specify form fields in the cfargument tags, they do not necessarily 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 to 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. Last updated 1/20/2012