Table of Contents
Advertisement
The model of an included page is that it is part of your page; it just resides in a separate file. The
tag cannot pass parameters to the included page, but the included page has access to
cfinclude
all the variables on the page that includes it. The following figure shows this model:
Using the cfinclude tag
When you use the
the page that includes another page is referred to as the calling page. When ColdFusion
encounters a
cfinclude
processing the included page. The included page can also set variables in the calling page.
The following line shows a sample
<cfinclude template = "header.cfm">
Note: You cannot break CFML code blocks across pages. For example, if you open a
block in a ColdFusion page, you must close the block on the same page; you cannot include the
closing portion of the block in an included page.
ColdFusion searches for included files as follows:
•
The
template
•
If the template value is prefixed with a forward slash (/), ColdFusion MX searches for the
included file in directories that you specify on the Mappings page of the ColdFusion MX
Administrator.
Caution: A page must not include itself. Doing so causes an infinite processing loop, and you must
stop the ColdFusion server to resolve the problem.
To include code in a calling page:
Create a ColdFusion page named header.cfm that displays your company's logo. Your page can
1
consist of just the following lines, or it can include many lines to define an entire header:
<img src="mylogo.gif">
<br>
(For this code to work, you must also put your company's logo as a GIF file in the same
directory as the header.cfm file.)
Create a ColdFusion page with the following content:
2
<html>
<head>
tag to include one ColdFusion page in another ColdFusion page,
cfinclude
tag it replaces the tag on the calling page with the output from
cfinclude
attribute specifies a path relative to the directory of the calling page.
tag:
Including pages with the cfinclude tag
cfoutput
165
Advertisement
Table of Contents
Troubleshooting
Related Manuals for MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX
Related Products for MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX
- MACROMEDIA COLDFUSION MX 61-CFML
- MACROMEDIA COLDFUSION MX 61-GETTING STARTED BUILDING COLDFUSION MX
- MACROMEDIA COLDFUSION MX 61 - INSTALLING COLDFUSION MX FOR IBM WEBSPHERE APPLICATION SERVER
- MACROMEDIA COLDFUSION MX 61 - CONFIGURING AND ADMINISTERING COLDFUSION MX
- MACROMEDIA COLDFUSION MX 7.0.2-USING COLDFUSION MX WITH FLEX 2
- MACROMEDIA 38000382 - Macromedia JRun - Mac
- MACROMEDIA 38028779 - Macromedia Dreamweaver - Mac
- MACROMEDIA BREEZE
Need help?
Do you have a question about the COLDFUSION MX 61-DEVELOPING COLDFUSION MX and is the answer not in the manual?
Questions and answers