Sintaxe de diretiva de inclusão do lado do servidor
[Esta documentação destina-se apenas à visualização e está sujeita a alterações em versões posteriores. Os tópicos em branco estão incluídos como espaços reservados.]
Insere o conteúdo de um arquivo especificado dentro de um aplicativo ASP.Arquivo de rede, 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 do 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.
Remarks
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 de uma 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 de 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), geralmente a abordagem preferida no ASP.NET é usar controles de usuário da Web.Controles de usuário fornecem um modelo de programação orientada a objeto e inclui a funcionalidade muito maior do que no lado do servidor.Para obter detalhes, consulte:ASP.NET User Controls.
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 personalizada. 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
Concepts
ASP.NET Web Page Syntax Overview