@ WebHandler

Définit des attributs et des options de compilation pour les fichiers de gestionnaire HTTP (.ashx).

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

Attributs

• Class
  Spécifie le nom de la classe qui sera compilée dynamiquement lorsque le gestionnaire sera demandé. Cette valeur peut référencer toute classe qui hérite de IHttpHandler et peut inclure un nom de classe qualifié complet.

• CodeBehind
  Spécifie le nom du fichier compilé qui contient la classe associée au gestionnaire. Cet attribut n'est pas utilisé au moment de l'exécution.

  Remarque
  Cet attribut est inclus pour la compatibilité avec les versions antérieures d'ASP.NET.

• CompilerOptions
  Spécifie une chaîne contenant les options utilisées pour compiler le gestionnaire. En C# et Visual Basic, il s'agit d'une séquence de commutateurs de ligne de commande du compilateur. Pour plus d'informations sur les options du compilateur, consultez Options du compilateur C# et Compilateur Visual Basic.

• Debug
  true si le gestionnaire doit être compilé avec les symboles de débogage ; sinon, false. Dans la mesure où ce paramètre affecte les performances, affectez uniquement la valeur true à l'attribut lors du développement.

• Description
  Donne une description du gestionnaire. Cette valeur est ignorée par l'analyseur ASP.NET.

• Language
  Spécifie le langage utilisé lors de la compilation de tout le code dans le gestionnaire. Les valeurs peuvent représenter n'importe quel langage .NET Framework, parmi lesquels Visual Basic, C# ou JScript. Un seul langage peut être utilisé par gestionnaire.

• WarningLevel
  Indique le niveau d'avertissement du compilateur auquel vous souhaitez que le compilateur traite des avertissements comme des erreurs, provoquant ainsi l'abandon de la compilation du gestionnaire. Les niveaux d'avertissement possibles sont compris entre 0 et 4. Pour plus d'informations, consultez la propriété WarningLevel.

Notes

Cette directive est uniquement valide dans les fichiers utilisés comme gestionnaires HTTP. Par défaut, ASP.NET traite les fichiers avec l'extension de nom de fichier .ashx comme des gestionnaires.

Remarque

Si vous ne souhaitez pas utiliser l'extension de nom de fichier .ashx pour vos gestionnaires, vous pouvez créer un gestionnaire comme une classe standard (un fichier .cs ou .vb) qui implémente l'interface IHttpHandler.Un fichier de classe de gestionnaire ne requiert pas la directive @ WebHandler.Vous devez ensuite inscrire votre extension de nom de fichier par défaut auprès d'ASP.NET.Pour plus d'informations, consultez Comment : enregistrer des gestionnaires HTTP.

Vous pouvez inclure uniquement une directive @ WebHandler par fichier. Vous pouvez définir un seul attribut Language par directive @ WebHandler, car un seul langage peut être utilisé par gestionnaire.

Remarque
La directive @ WebHandler a plusieurs attributs en commun avec d'autres directives qui s'appliquent à un fichier source entier, telles que la directive @ Page qui est utilisée dans les fichiers .aspx pour les pages Web.

Pour définir plusieurs attributs de la directive @ WebHandler, séparez chaque paire attribut/valeur par un espace. N'incluez pas d'espace de l'un et l'autre côté du signe égal (=) qui relie l'attribut à sa valeur.

Exemple

L'exemple de code suivant indique au compilateur de page ASP.NET d'utiliser Visual Basic comme langage de code incorporé et spécifie un nom de classe.

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

Voir aussi

Référence

Syntaxe des directives de modèles de texte

@ Page

IHttpHandler

Handlers

Concepts

Vue d'ensemble des gestionnaires HTTP et des modules HTTP