Server-Side Include Directive Syntax
Insere o conteúdo de um arquivo especificado dentro de um aplicativo ASP.NET file, incluindo páginas da Web (arquivos. aspx), arquivos de controle de usuário (arquivos. ascx) e arquivos global. asax..
<!-- #include file|virtual="filename" -->
Atributos
File
O nome do arquivo é um caminho físico do diretório que contém o arquivo com o #include diretiva. Esse caminho pode ser relativo.Observação
O arquivo incluído pode estar no mesmo diretório ou subdiretório; ele não pode estar em um diretório acima no arquivo com o #include diretiva.
Virtual
O nome de arquivo é um caminho virtual de um diretório virtual no seu site da Web. Esse caminho pode ser relativo.Observação
Essa técnica é recomendada devido a possíveis alterações no caminho físico de um arquivo.
Comentários
O valor atribuído para o File ou Virtual atributo deve ser colocado entre aspas (""). O arquivo incluído é processado antes que qualquer código dinâmico seja executado. Incluir arquivos podem ser usados para conter tudo, desde o texto estático (como, por exemplo, um cabeçalho de página comuns ou o endereço da empresa) para o código do lado do servidor comum, controles ou blocos de marcações HTML que um desenvolvedor deseja inserir em outras páginas.
Observação
Embora você ainda pode usar o #include a marca com o objetivo de reutilização de código (colocando código comum do lado do servidor, controles ou marcação HTML dentro de um arquivo para incluir em outras páginas da Web), freqüentemente a abordagem preferida no ASP.NET é usar controles de usuário da Web.Os controles de usuário fornecem um modelo de programação orientada a objeto e inclui a funcionalidade muito maior do que o lado do servidor.Para obter detalhes, consulte:Controles de usuário do ASP.NET.
O #include marca deve ser colocada dentro de delimitadores de comentário HTML ou XML para evitar que seja interpretado como texto literal.
Exemplo
O exemplo de código a seguir demonstra como você pode usar o servidor incluem a sintaxe da diretiva para chamar os arquivos que irá criar um cabeçalho e rodapé em uma página ASP.NET page. Ambos estão usando caminhos relativos.
<html>
<body>
<!-- #Include virtual="/include/header.inc" -->
Here is the main body of the .aspx file.
<!-- #Include virtual="/include/footer.inc" -->
</body>
</html>
Consulte também
Conceitos
Visão geral da sintaxe de página da Web ASP.NET