@ WebHandler

Определяет атрибуты и параметры компиляции для файлов обработчика HTTP (ASHX).

<%@ WebHandler attribute="value" [attribute="value"...] %>

Атрибуты

• Class
  Задает имя класса, который будет динамически компилироваться при запросе обработчика. Это значение может ссылаться на любой класс, наследуемый от IHttpHandler, и может содержать полное имя класса.

• CodeBehind
  Задает имя откомпилированного файла, содержащего связанный с обработчиком класс. Этот атрибут не используется во время выполнения.

  Примечание
  Этот атрибут включен для обеспечения совместимости с предыдущими версиями ASP.NET.

• CompilerOptions
  Задает строку, содержащую параметры для компиляции обработчика. Для C# и Visual Basic эта строка представляет собой последовательность переключателей командной строки компилятора. Дополнительные сведения о параметрах компилятора см. в разделах Параметры компилятора C# и Компилятор Visual Basic.

• Debug
  Если для компиляции отладчика должны использоваться символы отладки, следует задать значение true; в противном случае — значение false. Поскольку данный параметр влияет на производительность, атрибуту следует задать значение true только во время разработки.

• Description
  Предоставляет текстовое описание обработчика. Это значение не обрабатывается анализатором ASP.NET.

• Language
  Задает язык, используемый при компиляции всего кода в обработчике. Значения могут быть любым поддерживаемым .NET Framework языком, включая Visual Basic, C# или JScript. Для каждого обработчика используется только один язык.

• WarningLevel
  Определяет уровень предупреждений компилятора, при котором он будет рассматривать предупреждения как ошибки, прерывая, таким образом, компиляцию обработчика. Возможные пороги предупреждений — от 0 до 4. Дополнительные сведения см. в разделе свойства WarningLevel.

Заметки

Эта директива является допустимой только в файлах, используемых в качестве обработчиков HTTP. По умолчанию ASP.NET рассматривает файлы с расширением ASHX как обработчики.

Примечание

Если вы не хотите использовать расширение файла ASHX для обработчиков, можно создать обработчик в виде стандартного класса (файл CS или VB), реализующего интерфейс IHttpHandler.Для файла класса обработчика директива @ WebHandler не требуется.После этого в ASP.NET можно зарегистрировать предпочтительное расширение имени файла.Дополнительные сведения см. в разделе Практическое руководство. Регистрация обработчиков HTTP-данных.

Один файл может содержать только одну директиву @ WebHandler. Для каждой директивы @ WebHandler определяется только один атрибут Language, поскольку для обработчика можно использовать только один язык.

Примечание
Директива @ WebHandler располагает рядом атрибутов, общих для других директив, которые применяются ко всему исходному файлу, например директива @Page, которая используется в файлах .aspx для веб-страниц

Чтобы определить несколько атрибутов для директивы @ WebHandler, каждую пару атрибут/значение следует разделить одиночным пробелом. Не используйте пробел ни с какой стороны знака равенства (=), связывающего атрибут с его значением.

Пример

В следующем примере кода указывается, что компилятор страниц ASP.NET должен рассматривать Visual Basic как язык встраиваемого кода, а также задается имя класса.

<%@ WebHandler Language="VB" Class="MyTestHandler" %>

См. также

Ссылки

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

@ Page

IHttpHandler

Handlers

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

Общие сведения об обработчиках HTTP-данных и HTTP-модулях