webARTz | INCLUDE – Inclusão de arquivos

INCLUDE – Inclusão de arquivos

Realizar a inclusão de um arquivo é muito útil, quando, por exemplo, você cria funções genéricas que podem ser utilizadas em todo o site. Pode-se incluir arquivos de qualquer tipo. Os mais comuns são os .txt, .inc, .html, .php e .asp.

Existem duas maneiras de incluir um arquivo:

INCLUDE FILE
INCLUDE VIRTUAL

O INCLUDE FILE toma como endereço a partir de onde seu arquivo atual está. Já o INCLUDE VIRTUAL utiliza a raiz do site como endereço.

O exemplo a seguir ilustra essa situação:

Diretórios

Na estrutura acima os diretórios que realmente nos importa é o diretório MinhasFuncoes e o MeuSite.

No diretório MinhasFuncoes encontra-se o arquivo funcoes_data.asp que contém uma função de data como segue abaixo:

Site da web Padrão\MinhasFuncoes\ funcoes_data.asp

1
2
3
4
5

<%
Function data_completa
response.write formatDateTime(date(),1)
end function
%>

No diretório MeuSite, existe um subdiretório home onde dentro dele encontra-se o arquivo index.asp , que é o arquivo que estou desenvolvendo. Neste arquivo eu desejo utilizar a função data_completa, para isso preciso realizar a inclusão do arquivo funcoes_data.asp. Segue como seria a inclusão do arquivo utilizando INCLUDE FILE e INCLUDE VIRTUAL:

<!– #INCLUDE FILE=”../../MinhasFuncoes/funcoes_data.asp” –>

<!– #INCLUDE VIRTUAL=”/MinhasFuncoes/funcoes_data.asp” –>

A diferença entre os dois modos é bem visível, já que quando se usa o INCLUDE FILE você deve indicar o caminho a partir do diretório onde está o arquivo que você está trabalhando (Site da web Padrão\MeuSite\home\index.asp) até o arquivo a ser incluso, no exemplo deve-se subir dois níveis utilizando “../”. Já com o INCLUDE VIRTUAL, deve-se indicar o caminho a ser incluído a partir da raiz do site. O INCLUDE VIRTUAL é mais prático e mais cômodo, pois se a qualquer momento você mudar o local do arquivo index.asp, por exemplo, você não precisa se preocupar em acertar os includes por que eles estão sendo referenciados a partir da raiz.

Segue o código do arquivo index.asp:

Site da web Padrão\MeuSite\home\index.asp