@ WebHandler
Mise à jour : novembre 2007
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..gif "Remarque")
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 vont de 0 à 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 enregistrer votre extension de nom de fichier par défaut avec 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
Concepts
Vue d'ensemble des gestionnaires HTTP et des modules HTTP