Синтаксис директив Include на стороне сервера

Статья
08/11/2011

Вставляет содержимое указанного файла в файл ASP.NET, включая веб-страницы (файлы.aspx), файлы пользовательских элементов управления (файлы .ascx) и файлы Global.asax.

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

Атрибуты

File
Имя файла является физическим путем и задается по отношению к папке, содержащей файл с директивой #include. Этот путь может быть относительным.

Примечание
Включаемый файл может находиться в той же папке или во вложенной папке; он не может находиться в папке выше файла с директивой #include.

Virtual
Имя файла является виртуальным путем и задается по отношению к виртуальной папке веб-узла. Этот путь может быть относительным.

Примечание
Рекомендуется использовать данный подход, поскольку физический путь к файлу может измениться.

Заметки

Значение, присвоенное атрибуту File или Virtual, должно быть заключено в кавычки (""). Включаемый файл обрабатывается перед выполнением любого динамического кода. Включаемые файлы могут использоваться для хранения любых данных, начиная от статического текста (например, общий заголовок страницы или адрес компании) до общего кода на стороне сервера, элементов управления или блоков разметки HTML, вставляемых разработчиками на другие страницы.

Примечание
Несмотря на то, что для повторного использования кода (размещая общий код на стороне сервера, элементы управления или разметку HTML в фале, который будет включен в другие веб-страницы) по-прежнему можно применять тег #include, рекомендуемым подходом в ASP.NET является работа с пользовательскими веб-элементами управления.Пользовательские элементы управления предоставляют объектно-ориентированную программную модель и обладают большей функциональностью по сравнению с техникой включения на стороне сервера.Дополнительные сведения см. в разделе Пользовательские элементы управления ASP.NET.

Несмотря на то, что для повторного использования кода (размещая общий код на стороне сервера, элементы управления или разметку HTML в фале, который будет включен в другие веб-страницы) по-прежнему можно применять тег #include, рекомендуемым подходом в ASP.NET является работа с пользовательскими веб-элементами управления.Пользовательские элементы управления предоставляют объектно-ориентированную программную модель и обладают большей функциональностью по сравнению с техникой включения на стороне сервера.Дополнительные сведения см. в разделе Пользовательские элементы управления ASP.NET.

Тег #include должен быть заключен в теги комментариев HTML/XML, в противном случае он будет интерпретирован как обычный текст.

Пример

В следующем примере кода синтаксис директивы include на стороне сервера применяется для вызова файлов, создающих верхний и нижний колонтитулы на странице ASP.NET. В обоих случаях используются относительные пути.

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

См. также

Основные понятия

Общие сведения о синтаксисе веб-страниц ASP.NET

Другие ресурсы

Пользовательские элементы управления ASP.NET

Поделиться через