Programming ColdFusion

Name

CFFLUSH — New in ColdFusion 5.0

Synopsis

<CFFLUSH>

Flushes all currently available content to the client. CFFLUSH is typically used within loops or output queries to send results back to the client in incremental chunks. The first time a CFFLUSH tag is encountered on a page, it sends all the HTTP headers for the request along with any generated content up to the position in the template where the tag is encountered. Successive CFFLUSH tags return any content generated since the previous flush. Once a CFFLUSH tag has been used in a template, you can’t use any other CFML tags that write to the HTTP header; doing so causes ColdFusion to throw an error because the header has already been sent to the browser. These tags include CFCONTENT, CFCOOKIE, CFFORM, CFHEADER, and CFHTMLHEAD. In addition, attempting to set a variable in the cookie scope with the CFSET tag results in an error because cookies are passed from the server to the browser in the HTTP header.

Attribute

INTERVAL=" integer "

The minimum number of bytes that should be returned by the server before the output buffer is flushed. Optional.