Compartilhar via

Sintaxe de diretiva de inclusão do lado do servidor

  • Artigo

Insere o Sumário de um arquivo especificado dentro de um arquivo do ASP.NET, 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
    nome de arquivo é um caminho físico do diretório que contém o arquivo com o #include diretiva. Esse caminho pode ser relativo.

    ObservaçãoObservação:

    O arquivo incluído pode estar no mesmo diretório ou em uma subdiretório; ela não pode ser em um diretório acima no arquivo com o #include diretiva.

  • Virtual
    nome de arquivo é um caminho virtual de um diretório virtual em seu site. Esse caminho pode ser relativo.

    ObservaçãoObservação:

    Essa técnica é recomendada devido a alterações possíveis no caminho físico de um arquivo.

Comentários

O valor atribuído à File ou Virtualatributo deve ser colocado entre aspas (""). O arquivo incluído é processado antes da execução dinâmica de código. Incluir arquivos podem ser usados para conter qualquer item do texto estático (por exemplo, um cabeçalho de página comuns ou um endereço da empresa) comum código do lado do servidor, controles ou blocos de que um desenvolvedor deseja inserir dentro Outros páginas.

ObservaçãoObservação:

Embora você ainda pode usar o #include marca para fins de reutilização de código (colocando código de servidor comuns, controles ou marcação HTML dentro de um arquivo para incluir em outras páginas da Web), muitas vezes a abordagem preferencial 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 muito maior funcionalidade de servidor. Para obter detalhes, consulte:Controles de usuário do ASP.NET.

The #include marca deve ser colocada dentro de delimitadores de comentário HTML ou XML para evitar que está sendo interpretada sistema autônomo texto literal.

Exemplo

O exemplo de código a seguir demonstra como você pode usar o servidor incluir sintaxe diretriz para telefonar arquivos que criar um cabeçalho e rodapé em uma página ASP.NET. 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

Outros recursos

Controles de usuário do ASP.NET