Partager via

HttpEncoder Classe

Définition

Espace de noms:
System.Web.Util
Assemblys:
System.Web.dll, System.Web.Services.dll

Fournit l’encodage et la logique de décodage.

public ref class HttpEncoder
public class HttpEncoder
type HttpEncoder = class
Public Class HttpEncoder
Héritage
Object
HttpEncoder
Dérivé

Remarques

La classe contient l’encodage et la logique de décodage utilisées par des méthodes dans des classes telles que HttpUtility, HttpServerUtilityet HttpResponseHeader.

Vous pouvez hériter de la HttpEncoder classe et remplacer son comportement pour personnaliser le comportement d’encodage et de décodage par défaut de ASP.NET. Vous définissez ensuite la EncoderType propriété de la HttpRuntimeSection classe pour configurer votre classe personnalisée.

Une classe personnalisée pour l’encodage et le décodage qui dérive de HttpEncoder peut remplacer le comportement d’encodage et de décodage intégré ASP.NET ou modifier uniquement les aspects sélectionnés de celui-ci.

Vous pouvez configurer le type d’encodage personnalisé dans ASP.NET pour remplacer ou compléter le comportement d’encodage suivant :

  • Encodage HTML

  • Encodage d’attribut HTML

  • Encodage d’URL

  • Encodage du chemin d’URL

  • Nom d’en-tête HTTP et encodage de valeur d’en-tête

Par défaut, ASP.NET applications sont configurées pour utiliser le AntiXssEncoder type pour l’encodage de sortie.

L’exemple suivant d’un fichier Web.config au niveau de l’application montre comment le AntiXssEncoder type est défini pour une application ASP.NET :

<httpRuntime requestValidationMode="4.5" encoderType="System.Web.Security.AntiXss.AntiXssEncoder, System.Web, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>

Le paramètre de configuration de l’exemple définit la AntiXssEncoder classe pour effectuer tout l’encodage de sortie dans l’application. Pour plus d’informations, consultez la vue d’ensemble de la AntiXssEncoder classe.

Notes pour les héritiers

Lorsque vous créez une classe d’encodeur personnalisée et remplacez les méthodes de base de la classe de base, l’encodeur dérivé peut lever une exception de l’une des méthodes substituées. Toutefois, dans les cas suivants, la levée d’une telle exception peut entraîner un comportement inattendu dans ASP.NET :

  • Si ASP.NET affiche une page d’erreur provoquée par une exception non gérée levée à partir d’un encodeur personnalisé, ASP.NET n’essaie pas d’encoder sa sortie d’erreur en appelant l’encodeur personnalisé. Cela évite les conditions d’erreur récursives.

  • Lorsque ASP.NET envoie des en-têtes HTTP à IIS, ASP.NET n’a pas de provision pour les exceptions non gérées. Par conséquent, la page d’erreur de ASP.NET standard est affichée (si les paramètres de configuration permettent à cette page d’être affichée).

Constructeurs

Nom Description
HttpEncoder()

Initialise une nouvelle instance de la classe HttpEncoder.

Propriétés

Nom Description
Current

Obtient ou définit le HttpEncoder type qui sera utilisé dans une application.
Default

Obtient une référence à l’encodeur par défaut pour ASP.NET.

Méthodes

Nom Description
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
HeaderNameValueEncode(String, String, String, String)

Encode un nom d’en-tête et une valeur dans une chaîne qui peut être utilisée comme en-tête HTTP.
HtmlAttributeEncode(String, TextWriter)

Encode une valeur entrante dans une chaîne qui peut être insérée dans un attribut HTML délimité à l’aide de guillemets simples ou doubles.
HtmlDecode(String, TextWriter)

Décode une valeur à partir d’une chaîne encodée HTML.
HtmlEncode(String, TextWriter)

Encode une chaîne dans une chaîne encodée HTML.
JavaScriptStringEncode(String)

Encode une chaîne.
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)
UrlEncode(Byte[], Int32, Int32)

Encode un tableau de caractères qui ne sont pas autorisés dans une URL en équivalent hexadécimal d’entité de caractères.
UrlPathEncode(String)

Encode une sous-section d’une URL.

S’applique à

Voir aussi