Server Side Includes (SSI) with ASP

Server Side Includes (SSI) with ASP

People often have identical sections of code spread throughout many ASP pages, typically code at the top of the page (usually referred to as the header) and the lower part of the page (the footer). Similarly, you may have code that performs a certain set of instructions that you are repeating across multiple pages. Consider an example:-

<%
If foobar="yes" then
response.write "YES!"
Else
response.write "NOT YES!"
End if
%>

Ok, ok... it's simple, but imagine that you used this on multiple pages. What's wrong with this picture?

Well... you don't have to think about that long before realising that if you ever wanted to change something about that piece of code, you'd have your work cut out. you would have to change every page... everyone has done this at some stage and luckily most usually take the steps to learn a way around this problem.

If we could save our valuable chunk of code into a file and have that file accessed whenever we needed the code, then we no longer have a problem when it comes to changing things, as we simply update one file. Include files or Server Side Includes (SSI) as they are more commonly known are a powerful way to not only save time when it comes to maintaining and updating a site, but also increase efficiency and speed of that site too!

Ok, lets see how we use an include file... to start with we need to use one of two methods. The first one allows for including files relatively. By that I mean relative to the directory the ASP file that is using the include file resides. The second method includes files virtually. Including files virtually means that the path is taken from the root directory.

Consider that we are going to have a file (/main/somefile.asp) include another file (/includes/someinclude.asp).

To demonstrate, relative inclusion, look at this:-

<%
Response.Write "executing included code now"
%>
<!--#include file="../includes/someinclude.asp"-->
<%
Response.write "done executing included code"
%>

And here, we give an example of the other method, virtual inclusion:-

<%
Response.Write "executing included code now"
%>
<!--#include virtual="/includes/someinclude.asp"-->
<%
Response.write "done executing included code"
%>

Note the slight difference between the two methods. With virtual inclusion, you can move the file that calls upon the include file anywhere without affecting the outcome, because the path is always relative to the root. The same cannot be said however for relative inclusion. If you move a file that is using relative inclusion to a different directory, you'll most likely find the relative path is no longer correct.

From the examples above, you may also notice that both methods, when calling the include do so OUTSIDE of the ASP script block. This because #include declarations are not interpreted by ASP. Include files are included before a single line of ASP is processed which means the following WONT work:-

%lt;%
Page=request.form("page")
%>
<!--#include file="../includes/<%=page%>.asp"-->

We were attempting to perform a dynamic include and I would be the first to admit that the above would be very useful indeed if in fact it were possible. I do intend to cover a few methods that work around this set back but I know you will now be itching to get started right away on using include files to even worry about this, so I will cover it in a future article.

I hope that you have found the above informative and hope it inspires you all to write code that's more efficient and more easily maintained.

Rob Collyer, experienced with 20 years programming knowledge and site administrator of www.webforumz.com - Copyright 2003-2004

BigNews.biz (press release)

Leading Web Development Firm Offers Tips on Choosing the Right e-Commerce ... BigNews.biz (press release) Established in 2003, dzine it, inc. is a leader in Custom web development, programming and design solutions for small and large business, agencies. ...

New, moving or expanding: Web development company opens in Sartell St. Cloud Times SARTELL — Stonebreakers Design, a new Web development company based in Sartell, ... and more »

The UK's Best Web Development Firms Named by uk.topseos.com for March 2010 Online PR News (press release) The March 2010 rankings of the best web development firms were released by uk.topseos.com, the independent authority on search vendors. ... and more »

TrustedReviews

8 things you didn't know about Windows Phone 7 NetworkWorld.com If you're already using Microsoft's core Windows and Web development tools and frameworks, you're qualified to start creating Windows Phone applications. ... Microsoft Offers Silverlight 4 Release CandidateInternetNews.com Microsoft wooing developers to Windows Phone (video)CNET Download Windows Phone 7 Development ToolsTech Exclusive PR Web (press release) -BetaNews all 630 news articles »

The Guardian (blog)

Microsoft Touts Faster Speed With IE9 Preview ChannelWeb This design enables better performance for the Web development patterns that occur on many real world sites," Hachamovitch said. The desired result will be ... Microsoft Previews Internet Explorer 9CTO Edge (blog) Microsoft Encourages Developers To Test Drive IE9NewsFactor Network Microsoft Offers Sneak Peek at Internet Explorer 9Digitaltrends.com Softpedia -Technologizer (blog) all 225 news articles »

Learning Tree International Surpasses Two Million Course Participants MarketWatch (press release) ... project management; leadership and business skills; Web development; operating systems; databases; networking; IT security; and software development. ... and more »

Complete PHP Development Company India – Hire PHP Developer India BigNews.biz (press release) After successful 10 years competition in web development and software development business we serve the world class technology to our clients. ...

CNN	A webmaster without the high-speed Web CNN Fields said she has turned down Web development projects because she simply couldn't do them from home. "It would just take me forever," she said. ... and more »

Chamber Selects MAGNET to Enhance Membership Program Carolina Newswire (press release) ... web development, communications and research firms, as its partner in a three-year effort to bolster the Chamber's membership and awareness program. ... and more »

Web Design Company Offering Dedicated PHP Developers at USD 1500 SBWire (press release) Today where every web development companies are offering discounts in their PHP development service, questions are always raised about the quality of work. ... and more »