Did you find this useful?
Socialize it today.


Using the #include Directive in ASP

Sunday, August 26, 2012

tags ASP

For most websites, the pages that make up the site all share a common layout and set of elements. ASP allows you include external files within ASP pages, by using the #include ASP directive. This is very useful for creating common pieces of ASP code, which can be reused by many ASP pages within your ASP application. For example, you may want to implement a common header or footer. If you were using plain HTML, you would have to copy that code on each page in your site. If you needed to make a change, you would need to open each file and update the pages. With the #include directive, you can separate the header and footer into two different files, then reference each of the files from within each web page. If you need to make a change to the header or the footer section, you only have to update the two files.

You can insert the contents of one file such as a text, HTML, or even ASP file, into another ASP file, by using the ASP #include directive. The web server inserts the external file prior to serving the HTML output back to the user's browser.


Syntax

To include a file in an ASP page, place the #include directive inside of HTML comments tags.

<!-- #include file|virtual = "filename" -->


File

Use the file keyword to indicate a relative path. Begin the relative path with the name of the directory that includes the file. For example, if you have a file name called "header.inc" and it is located in a folder called "includes", then the following line would insert the contents of "header.inc".


<!-- #include file = "includes\header.inc" -->


Virtual

Use the virtual keyword to indicate a path beginning with a virtual directory. If a file named "header.inc" is located in a virtual directory named "/includes", then the following line would insert the contents of "header.inc"


<!-- #include virtual = "/includes/header.inc" -->


You should note that the files you are including do not require the .inc extension. If you have sensitive information in your include file, you may want to configure the file as an ASP file so that even if the file is accessed directly, the server-side code is not exposed back to the user as plain HTML. In addition, note that include files are processed and inserted before the ASP scripts are executed. For example, the following code will not work as expected:


<%
fileName="footer.inc"
%>
<!--#include file="<%fileName%>"-->


Please help us spread the word by socializing it today!

email contact us

Did you find something wrong with the information on this page? Please take a moment to report it to us so that we can continue to improve the quality of the information on this site. Click here to report an issue with this page.



Recommended Books & Training Resources

Sams Teach Yourself Active Server Pages 3.0 in 21 Days Beginning ASP Databases ASP In A Nutshell