@ WebHandler

Artigo
08/25/2010

Define atributos e opções de compilação para arquivos de manipulador (.ashx) HTTP.

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

Atributos

Class
Especifica o nome da classe que será compilado dinamicamente quando o manipulador é solicitado. Esse valor pode referenciar qualquer classe que herda a partir de IHttpHandler e pode incluir um nome de classe totalmente qualificado.
CodeBehind
Especifica o nome do arquivo compilado que contém a classe associada com o manipulador. Esse atributo não é usado em time de execução.

Observação:

Esse atributo é incluído para compatibilidade com versões anteriores do ASP.NET.
CompilerOptions
Especifica uma seqüência de caracteres que contém opções usadas para compilar o manipulador. No Visual Basic e translation from VPE for Csharp, isso é uma sequência de opções de linha de comando do compilador. Para obter mais informações sobre opções do compilador, consulte Opções do Compilador C# e Compilador do Visual Basic.
Debug
true Se o manipulador deve ser compilada com símbolos de depurar; caso contrário, false. Porque essa configuração afeta o desempenho, defina o atributo para true somente durante o desenvolvimento.
Description
Fornece uma descrição de texto do manipulador. Este valor é ignorado pelo analisador ASP.NET.
Language
Especifica a linguagem usada durante a compilação de todo o código dentro do manipulador. Valores podem representar qualquer linguagem .NET estrutura, incluindo Visual Basic, translation from VPE for Csharp ou JScript. Apenas um linguagem pode ser usado por um manipulador.
WarningLevel
Indica o nível de aviso do compilador no qual você deseja tratar avisos sistema autônomo erros, o compilador, portanto, interrompendo a compilação do manipulador de. Níveis de aviso possíveis são 0 a 4. Para obter mais informações, consulte a propriedade WarningLevel.

Observação:
Esse atributo é incluído para compatibilidade com versões anteriores do ASP.NET.

Comentários

Essa diretiva é válida somente em arquivos usados sistema autônomo manipuladores de HTTP. Por padrão, o ASP.NET trata arquivos com a extensão de nome de arquivo .ashx sistema autônomo manipuladores.

Observação:
Se você preferir não usar a extensão de nome de arquivo .ashx para seus manipuladores, você pode criar um manipulador sistema autônomo uma classe padrão (um arquivo .cs ou .vb) que implementa o IHttpHandler interface. A handler class file does not require the @ WebHandler directive. Em seguida, você deve registrar sua extensão de nome de arquivo preferencial com o ASP.NET. Para obter detalhes, consulte:Como: Registrar manipuladores HTTP.

Se você preferir não usar a extensão de nome de arquivo .ashx para seus manipuladores, você pode criar um manipulador sistema autônomo uma classe padrão (um arquivo .cs ou .vb) que implementa o IHttpHandler interface. A handler class file does not require the @ WebHandler directive. Em seguida, você deve registrar sua extensão de nome de arquivo preferencial com o ASP.NET. Para obter detalhes, consulte:Como: Registrar manipuladores HTTP.

You can include only one @ WebHandler directive per file. You can define only one Language attribute per @ WebHandler directive, because only one language can be used per handler.

Observação:
O @ WebHandler directive has a number of attributes in common with other directives that apply to an entire source file, such as the @ Page directive which is used in .aspx files for Web pages.

To define multiple attributes for the @ WebHandler directive, separate each attribute/value pair with a single space. Não inclua um espaço em ambos os lados do sinal de igual (=) que conecta o atributo com o seu valor.

Exemplo

O exemplo de código a seguir instrui o compilador de página ASP.NET para usar o Visual Basic sistema autônomo o linguagem de código embutido e especifica um nome de classe.

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

Consulte também

Conceitos

Visão Geral sobre Módulos HTTP e Manipuladores HTTP

Referência

Partilhar via