@ WebHandler

Статья
11/16/2008

Обновлен: Ноябрь 2007

Определяет атрибуты и параметры компиляции для файлов обработчика 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.

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

Заметки

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

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

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

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

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

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

Пример

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

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

См. также

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

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

Ссылки

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