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