Partager via

HttpEncoder Classe

  • Référence

Définition

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

Fournit la logique d'encodage et 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 une logique d’encodage et de décodage qui est utilisée par les méthodes dans les classes telles que HttpUtility , HttpServerUtility et HttpResponseHeader .

Vous pouvez hériter de la HttpEncoder classe et substituer son comportement pour personnaliser le comportement par défaut d’encodage et de décodage 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 substituer le comportement d’encodage et de décodage ASP.net intégré ou modifier uniquement les aspects sélectionnés.

Vous pouvez configurer le type d’encodage personnalisé pour 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

  • Encodage de la valeur du nom et de l’en-tête HTTP

Par défaut, les applications ASP.NET sont configurées pour utiliser le AntiXssEncoder type pour tous les encodages de sortie.

L’exemple suivant à partir d’un fichier de 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 qu’elle effectue tout l’encodage de sortie dans l’application. Pour plus d’informations, consultez la AntiXssEncoder vue d’ensemble de la classe.

Notes pour les héritiers

Lorsque vous créez une classe d’encodeur personnalisée et substituez les méthodes de base de la classe de base, l’encodeur dérivé peut lever une exception à partir 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 effectue le rendu d’une page d’erreur provoquée par une exception non gérée qui a été 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.

-Quand ASP.NET envoie des en-têtes HTTP à IIS, ASP.NET n’a aucune provision pour les exceptions non gérées. Par conséquent, la page d’erreur standard ASP.NET s’affiche (si les paramètres de configuration autorisent l’affichage de cette page).

Constructeurs

HttpEncoder()

Initialise une nouvelle instance de la classe HttpEncoder.

Propriétés

Current

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

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

Méthodes

Equals(Object)

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

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

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

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

Encode une valeur entrante en 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 en HTML.
HtmlEncode(String, TextWriter)

Encode une chaîne sous la forme d'une chaîne encodée en HTML.
JavaScriptStringEncode(String)

Encode une chaîne.
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(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 des caractères non autorisés dans une URL sous la forme d'une entité de caractère hexadécimal équivalente.
UrlPathEncode(String)

Encode une sous-section d'une URL.

S’applique à

Voir aussi