@ WebHandler
Define os atributos e opções de compilação de arquivos (. ashx) do manipulador de HTTP.
<%@ WebHandler attribute="value" [attribute="value"...] %>
Atributos
Class
Especifica o nome da classe que será compilado dinamicamente quando o manipulador é solicitado. Esse valor pode fazer referência a qualquer classe que herda de IHttpHandler e pode incluir um nome de classe totalmente qualificado.CodeBehind
Especifica o nome do arquivo compilado que contém a classe associada ao manipulador. Esse atributo não é usado em tempo 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 contendo opções usadas para compilar o manipulador. No C# e Visual Basic, esta é uma seqüê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
trueSe o manipulador deve ser compilado com símbolos de depuração; Caso contrário, false. Como esta 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 ASP.Analisador de rede.Language
Especifica o idioma usado ao compilar todo o código dentro do manipulador. Valores podem representar qualquer.NET Framework, incluindo Visual Basic, C# ou JScript. Somente um idioma pode ser usado por um manipulador.WarningLevel
Indica o nível de aviso do compilador no qual você deseja o compilador tratar avisos como erros, assim, interrompendo a compilação do manipulador. Possíveis níveis de aviso são 0 a 4. Para obter mais informações, consulte a propriedade WarningLevel.
Comentários
Essa diretiva é válida somente em arquivos usados como manipuladores de HTTP. Por padrão, o ASP.NET trata os arquivos com a extensão de nome de arquivo. ashx como manipuladores.
Observação
Se você não deseja usar a extensão de nome de arquivo. ashx para seus manipuladores, você pode criar um manipulador como uma classe padrão (um arquivo. cs ou. vb) que implementa o IHttpHandler interface.Um arquivo de classe de manipulador não requer o @ WebHandler diretiva.Em seguida, você deve registrar sua extensão de nome de arquivo preferido com o ASP.NET.Para obter detalhes, consulte:Como: registrar manipuladores HTTP.
Você pode incluir apenas uma @ WebHandler diretiva por arquivo. Você pode definir apenas uma Language atributo por @ WebHandler diretiva, porque somente um idioma pode ser usado por manipulador.
Observação
O @ WebHandler diretiva tem um número de atributos em comum com outras diretivas que se aplicam a um arquivo de origem inteiro, como o @ Page diretiva que é usada em arquivos. aspx para páginas da Web.
Para definir vários atributos para o @ WebHandler diretiva, separe cada par de valor do atributo com um único espaço. Não inclua um espaço nos dois lados do sinal de igual (=) que conecta o atributo com o seu valor.
Exemplo
O exemplo de código a seguir instrui o ASP.Compilador NET personalizada para usar o Visual Basic como o embutido do código de idioma e especifica um nome de classe.
<%@ WebHandler Language="VB" Class="MyTestHandler" %>
Consulte também
Referência
Texto Sintaxe de modelo de diretiva