Macromedia coldfusion 4.5-cfml language reference Benutzerhandbuch

Seite von 608
Chapter 1:  ColdFusion Tags
121
CFLOCATION
CFLOCATION opens a specified ColdFusion page or HTML file. For example, you 
might use CFLOCATION to specify a standard message or response that you use in 
several different ColdFusion applications. Use the ADDTOKEN attribute to verify client 
requests.
Syntax
<CFLOCATION URL="url" ADDTOKEN="Yes/No">
URL
The URL of the HTML file or CFML page you want to open. 
ADDTOKEN
Optional. Yes or No. CLIENTMANAGEMENT must be enabled (see 
CFAPPLICATION). A value of Yes appends client variable information to the URL 
you specify in the URL argument. 
Example
<!--- This view only example shows the use of CFLOCATION --->
<HTML>
<HEAD>
<TITLE>CFLOCATION Example</TITLE>
</HEAD>
<BODY>
<H3>CFLOCATION Example</H3>
<P>CFLOCATION redirects the browser to a specified web resource;
normally, you would use this tag to go to another CF template or to 
an HTML file on the same server.  The ADDTOKEN attribute allows you to
send client information to the target page.
<P>The following is example code to direct you back to 
the CFDOCS home page (remove the comments and this information will
display within the frame):
<!--- <CFLOCATION URL="../../cfdocs/index.htm" ADDTOKEN="No"> --->
</BODY>
</HTML>