MACROMEDIA COLFUSION MX 7-CFML Reference page 149

cfflush
Description
Flushes currently available data to the client.
Category
Data output tags,
Syntax
<cfflush
interval = "integer number of bytes">
See also
cfcache, cfheader, cfinclude, cfsetting,
Attributes
Attribute Req/Opt
interval Optional
Usage
The first occurrence of this tag on a page sends back the HTML headers and any other available
HTML. Subsequent
previous flush.
When you flush data, ensure that enough information is available, as some browsers might not
respond if you flush only a small amount. Similarly, set the
bytes or more, but not thousands of bytes.
Use the
interval
in a or a
cfloop
Application.cfm file) might cause unexpected errors when CFML tags that modify HTML
headers are executed.
Caution: Because the
limitations, including the following: Using any of the following tags or functions on a page anywhere
after the
cfflush
,
cfhtmlhead cflocation
header, but cannot do so after a
tag to set a cookie anywhere on a page that has a
Using the
cfflush
tags, cause errors. If you save Client variables as cookies, any client variables that you set after a
tag are not saved in the browser.
cfflush
Note: Normally, the
the error page. The
variable resulting from a
has not been flushed. This content is not sent to the client. The content of the error page displays to
the client after the bytes that have been sent.
Page processing tags
Default Description
Integer. Flushes output each time this number of bytes becomes
available. HTML headers, and data that is already available
when the tag is executed, are omitted from the count.
tags on the page send only the output that was generated after the
cfflush
attribute only when a large amount of output will be sent to the client, such as
of a large query. Using this form globally (such as in the
cfoutput
tag sends data to the browser when it executes, it has several
cfflush
tag can cause errors or unexpected results:
, and . (These tags and functions normally modify the HTML
SetLocale
cfflush
tag within the body of several tags, including
tag discards the current output buffer and replaces it with the contents of
cferror
tag discards the current buffer. As a result, the
cfflush
tag after a
cferror
cfsilent
interval
cfcontent
tag, because the
cfflush
tag does not set the cookie in the browser.
cfflush
contains any contents of the output buffer that
cfflush
attribute for a few hundred
,
,
cfcookie cfform
sends the header.) Using the
,
cfsavecontent cfquery
Error.GeneratedContent
, ,
cfheader
cfset
, and custom
cfflush 149