Referência de Arquivo ASP

A instrução #include é usada para criar funções, cabeçalhos, rodapés ou outros elementos repetidos em várias páginas.

Instrução #include

Ao usar a instrução #include, podemos inserir outro arquivo ASP neste arquivo antes da execução do arquivo ASP no servidor. O comando #include é usado para criar funções, cabeçalhos, rodapés ou outros elementos repetidos em várias páginas.

Como usar a instrução #include

Existe um arquivo chamado "mypage.asp":

<html> 
<body> 
<h2>Palavras de Sabedoria:</h2>
<p><!--#include file="wisdom.inc"--></p> 
<h2>O tempo é:</h2>
<p><!--#include file="time.inc"--></p>
</body> 
</html>

Este é o arquivo "wisdom.inc":

"Nunca deve-se aumentar, além do necessário,"
o número de entidades necessárias para explicar qualquer coisa.

Este é o arquivo "time.inc":

<%
Response.Write(Time)
%>

O código-fonte visualizado no navegador deve ser semelhante a este:

<html>
<body>
<h2>Palavras de Sabedoria:</h2>
<p>"Nunca deve-se aumentar, além do necessário,</p>
o número de entidades necessárias para explicar qualquer coisa."</p>
<h2>O tempo é:</h2>
<p>11:33:42 AM</p>
</body>
</html>

Sintaxe de inclusão de arquivos:

Para referenciar arquivos no ASP, coloque o comando #include dentro de etiquetas de comentário:

<!--#include virtual="somefilename"-->

ou:

<!--#include file ="somefilename"-->

Palavra-chave Virtual

A palavra-chave virtual indica que o caminho começa pelo diretório virtual.

Se o arquivo "header.inc" estiver localizado no diretório virtual /html, a seguinte linha de código inserirá o conteúdo do arquivo "header.inc":

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

Palavra-chave File

A palavra-chave File indica um caminho relativo. O caminho relativo começa no diretório que contém o arquivo de referência.

Supondo que o arquivo esteja localizado na subpasta headers do diretório html, o seguinte código pode referenciar o conteúdo do arquivo "header.inc":

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

Nota:O caminho do arquivo referenciado é relativo ao arquivo de referência. Se o arquivo que contém a declaração #include não estiver no diretório html, essa declaração não terá efeito.

Você também pode usar a palavra-chave file e a sintaxe (..\) para referenciar arquivos no diretório superior.

Sugestões e comentários

No capítulo anterior, usamos ".inc" como sufixo para os arquivos referenciados. Nota: Se o usuário tentar visualizar diretamente os arquivos INC, o conteúdo desses arquivos será exposto. Se o conteúdo dos arquivos referenciados envolver informações confidenciais, é melhor usar "asp" como sufixo. O código-fonte dos arquivos ASP é compilado e não é visível. Os arquivos referenciados também podem referenciar outros arquivos, e um arquivo ASP pode referenciar o mesmo arquivo várias vezes.

Ponto importante:Antes da execução do script, o arquivo referenciado será processado e inserido.

O código abaixo não pode ser executado, pois o ASP executa o comando #include antes de atribuir valores às variáveis:

<%
fname="header.inc"
%>
<!--#include file="<%=fname%>"-->

Não é permitido incluir referências a arquivos entre os delimitadores de script:

<%
For i = 1 To n
  <!--#include file="count.inc"-->
Next
%>

Mas este script funciona:

<% For i = 1 to n %>
<!--#include file="count.inc" -->
<% Next %>