Sintaxis de directivas Include del servidor
[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].
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 ASP.NET User Controls.
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
ASP.NET Web Page Syntax Overview