Синтаксис директивы текстового шаблона

Задает параметры, используемые компиляторами страниц и пользовательских элементов управления при обработке файлов страниц ASP.NET Web Forms (.aspx) и файлов пользовательских элементов управления (.ascх).

Заметки

Если указанные директивы используются, то они могут располагаться в любом месте файла .aspx или .ascx, однако стандартный подход заключается в задании директив в начале файла. Каждая директива может содержать один или несколько характерных для нее атрибутов (в паре со значениями).

ПримечаниеПримечание

Директива @ Page может использоваться только в файлах .aspx, а директива @ Control — только в файлах .ascx.

В структуре страницы ASP.NET поддерживаются следующие директивы:

@ Page

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

@ Control

Задает определенные атрибуты для элемента управления, используемые анализатором и компилятором страниц ASP.NET. Может включаться только в файлы .ascx (пользовательские элементы управления).

@ Import

Импортирует явным способом пространство имен в страницу или пользовательский элемент управления.

@ Implements

Декларативно указывает, что страница или пользовательский элемент управления реализует заданный интерфейс .NET Framework.

@ Register

Связывает псевдонимы с пространствами имен и именами классов, что позволяет формировать пользовательские элементы управления и специализированные серверные элементы управления при их включении в запрашиваемую страницу или пользовательский элемент управления.

@ Assembly

Связывает сборку с текущей страницей в процессе компиляции, делая все классы и интерфейсы сборки доступными для использования на странице.

@ Master

Определяет главную страницу ASP.NET.

@ WebHandler

Определяет страницу IHttpHandler ASP.NET.

@ PreviousPageType

Позволяет обеспечить строгую типизацию в соответствии с предыдущей страницей, доступ к которой можно получить с помощью свойства PreviousPage.

@ MasterType

Присваивает имя класса свойству Master страницы ASP.NET, что позволяет использовать на странице строго типизированные ссылки на элементы главной страницы.

@ OutputCache

Декларативно управляет политиками кэширования выходных данных страницы или пользовательского элемента управления.

@ Reference

Декларативно связывает страницу или пользовательский элемент управления с текущей страницей или пользовательским элементом управления.

При использовании ASP.NET любой блок директив (<%@ %>), не содержащий явного имени директивы, обрабатывается как директива @ Page для страницы и как директива @ Control — для пользовательского элемента управления.

См. также

Ссылки

Page

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

Синтаксис страницы ASP.NET