Директивы ASP.NET — это инструкции для указания необязательных настроек, таких как регистрация пользовательского элемента управления и языка страниц. Эти параметры описывают, как веб-формы (.aspx) или страницы пользовательских элементов управления (.ascx) обрабатываются платформой .Net.
Синтаксис объявления директивы:
<%@ directive_name attribute=value [attribute=value] %>
В этом разделе мы просто представим директивы ASP.NET и будем использовать большинство из этих директив в руководствах.
Директива по применению
Директива Application определяет специфичные для приложения атрибуты. Он предоставляется в верхней части файла global.aspx.
Основной синтаксис директивы Application:
<%@ Application Language="C#" %>
Атрибутами директивы Application являются:
| Атрибуты | Описание |
|---|---|
| Inherits | Имя класса, от которого наследуется. |
| Описание | Текстовое описание заявки. Парсеры и компиляторы игнорируют это. |
| язык | Язык, используемый в кодовых блоках. |
Директива по сборке
Директива Assembly связывает сборку со страницей или приложением во время анализа. Это может появиться либо в файле global.asax для ссылок всего приложения, либо в файле страницы, в файле пользовательского элемента управления для ссылки на страницу или в пользовательском элементе управления.
Основной синтаксис директивы Assembly:
<%@ Assembly Name ="myassembly" %>
Атрибутами директивы Assembly являются:
| Атрибуты | Описание |
|---|---|
| название | Название сборки, которая будет связана. |
| Src | Путь к исходному файлу для динамической компоновки и компиляции. |
Директива по контролю
Директива control используется с пользовательскими элементами управления и отображается в файлах пользовательских элементов управления (.ascx).
Основной синтаксис директивы Control:
<%@ Control Language="C#" EnableViewState="false" %>
Атрибутами директивы Control являются:
| Атрибуты | Описание |
|---|---|
| AutoEventWireup | Логическое значение, которое включает или отключает автоматическую привязку событий к обработчикам. |
| ИмяКласса | Имя файла для элемента управления. |
| отлаживать | Логическое значение, которое включает или отключает компиляцию с отладочными символами. |
| Описание | Текстовое описание страницы управления, игнорируется компилятором. |
| EnableViewState | Логическое значение, которое указывает, поддерживается ли состояние просмотра в запросах страницы. |
| Явный | Для языка VB говорит компилятору использовать опцию явного режима. |
| Inherits | Класс, от которого наследуется контрольная страница. |
| язык | Язык для кода и сценария. |
| Src | Имя файла для класса code-behind. |
| строгий | Для языка VB говорит компилятору использовать опцию строгий режим. |
Директива по инструментам
Директива Implement указывает, что веб-страница, главная страница или страница управления пользователя должны реализовывать указанный интерфейс платформы .Net.
Основной синтаксис для директивы Implements:
<%@ Implements Interface="interface_name" %>
Директива об импорте
Директива Import импортирует пространство имен в веб-страницу, пользовательскую страницу управления приложением. Если директива Import указана в файле global.asax, то она применяется ко всему приложению. Если он находится на странице страницы управления пользователем, то он применяется к этой странице или элементу управления.
Основной синтаксис для директивы импорта:
<%@ namespace="System.Drawing" %>
Мастер Директива
Директива Master определяет файл страницы как главную страницу.
Основной синтаксис примера директивы MasterPage:
<%@ MasterPage Language="C#" AutoEventWireup="true" CodeFile="SiteMater.master.cs" Inherits="SiteMaster" %>
Директива MasterType
Директива MasterType назначает имя класса свойству Master страницы, чтобы сделать его строго типизированным.
Основной синтаксис директивы MasterType:
<%@ MasterType attribute="value"[attribute="value" ...] %>
Директива OutputCache
Директива OutputCache управляет политиками кэширования вывода веб-страницы или пользовательского элемента управления.
Основной синтаксис директивы OutputCache:
<%@ OutputCache Duration="15" VaryByParam="None" %>
Директива Страницы
Директива Page определяет атрибуты, специфичные для файла подкачки для анализатора страниц и компилятора.
Основной синтаксис директивы Page:
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" Trace="true" %>
Атрибуты директивы Page:
| Атрибуты | Описание |
|---|---|
| AutoEventWireup | Логическое значение, которое включает или отключает события страницы, которые автоматически привязываются к методам; например, Page_Load. |
| буфер | Логическое значение, которое включает или отключает буферизацию ответов HTTP. |
| ИмяКласса | Имя класса для страницы. |
| ClientTarget | Браузер, для которого сервер контролирует, должен отображать контент. |
| CodeFile | Название кода за файлом. |
| отлаживать | Логическое значение, которое включает или отключает компиляцию с отладочными символами. |
| Описание | Текстовое описание страницы, игнорируемое парсером. |
| EnableSessionState | Он включает, отключает или делает состояние сеанса доступным только для чтения. |
| EnableViewState | Логическое значение, которое включает или отключает состояние просмотра для запросов страниц. |
| ErrorPage | URL для перенаправления, если возникает необработанное исключение страницы. |
| Inherits | Название кода позади или другого класса. |
| язык | Язык программирования для кода. |
| Src | Имя файла кода за классом. |
| след | Включает или отключает трассировку. |
| TraceMode | Он показывает, как отображаются сообщения трассировки и сортируются по времени или категории. |
| Сделка | Указывает, поддерживаются ли транзакции. |
| ValidateRequest | Логическое значение, которое указывает, проверяются ли все входные данные по жестко закодированному списку значений. |
Директива PreviousPageType
Директива PreviousPageType назначает класс странице, так что страница строго типизирована.
Основной синтаксис для образца директивы PreviousPagetype:
<%@ PreviousPageType attribute="value"[attribute="value" ...] %>
Справочная Директива
Директива Reference указывает, что другая страница или пользовательский элемент управления должны быть скомпилированы и связаны с текущей страницей.
Основной синтаксис справочной директивы:
<%@ Reference Page ="somepage.aspx" %>
Директива о регистрации
Производная регистра используется для регистрации пользовательских серверных элементов управления и пользовательских элементов управления.
Основной синтаксис директивы Register: