Compartir a través de


Sintaxis de directivas Include del servidor

Inserta el contenido de un archivo especificado en un archivo ASP.NET, incluso las páginas Web (archivos .aspx), los archivos de controles de usuario (archivos .ascx) y los archivos Global.asax.

<!-- #include file|virtual="filename" -->

Atributos

  • File
    El nombre de archivo es una ruta de acceso física desde el directorio que contiene el archivo con la directiva #include. La ruta de acceso puede ser relativa.

    Nota

    El archivo incluido puede estar en el mismo directorio o en un subdirectorio, pero nunca en un directorio superior al del archivo que contiene la directiva #include.

  • Virtual
    El nombre del archivo es una ruta virtual de acceso desde un directorio virtual en el sitio Web. La ruta de acceso puede ser relativa.

    Nota

    Se recomienda esta técnica por la posibilidad de realizar cambios en la ruta de acceso física a un archivo.

Comentarios

El valor asignado al atributo File o Virtual debe incluirse entre comillas (""). El archivo incluido se procesa antes de que se ejecute cualquier código dinámico. Los archivos de inclusión se pueden utilizar para incluir cualquier tipo de información, desde texto estático (como un encabezado de página común o una dirección de empresa) hasta código de servidor, controles o bloques de formato HTML comunes que el desarrollador desee insertar en otras páginas.

Nota

Aunque se puede seguir utilizando la etiqueta #include para la reutilización del código (colocando el código de servidor, los controles o el formato HTML comunes en un archivo para incluirlo en otras páginas Web), en ASP.NET a menudo se prefiere utilizar los controles de usuario Web. Los controles de usuario proporcionan un modelo de programación orientada a objetos y una funcionalidad muy superior a la de servidor. Para obtener información detallada, vea Controles de usuario ASP.NET.

La etiqueta #include debe ir entre delimitadores de comentario HTML o XML para evitar que se interprete como texto literal.

Ejemplo

En el siguiente ejemplo de código se muestra cómo utilizar la sintaxis de directivas include de servidor para llamar a archivos que crearán un encabezado y un pie de página en una página ASP.NET. En ambos casos se utilizan rutas de acceso relativas.

<html>
   <body>
      <!-- #Include virtual="/include/header.inc" -->
        Here is the main body of the .aspx file.
      <!-- #Include virtual="/include/footer.inc" -->
   </body>
</html>

Vea también

Conceptos

Información general sobre sintaxis de páginas Web ASP.NET

Otros recursos

Controles de usuario ASP.NET