HttpEncoder Klass

Definition

Tillhandahåller kodnings- och avkodningslogik.

public ref class HttpEncoder
public class HttpEncoder
type HttpEncoder = class
Public Class HttpEncoder
Arv
HttpEncoder
Härledda

Kommentarer

Klassen innehåller kodnings- och avkodningslogik som används av metoder i klasser som HttpUtility, HttpServerUtilityoch HttpResponseHeader.

Du kan ärva från klassen HttpEncoder och åsidosätta dess beteende för att anpassa standardkodnings- och avkodningsbeteendet för ASP.NET. Sedan anger EncoderType du egenskapen för HttpRuntimeSection klassen för att konfigurera din anpassade klass.

En anpassad klass för kodning och avkodning som härleds från HttpEncoder kan åsidosätta det inbyggda ASP.NET kodnings- och avkodningsbeteendet eller bara ändra valda aspekter av den.

Du kan konfigurera den anpassade kodningstypen för i ASP.NET för att ersätta eller komplettera följande kodningsbeteende:

  • HTML-kodning

  • HTML-attributkodning

  • URL-kodning

  • URL-sökvägskodning

  • HTTP-huvudnamn och rubrikvärdekodning

Som standard konfigureras ASP.NET program för att använda typen AntiXssEncoder för all utdatakodning.

Följande exempel från en Web.config fil på programnivå visar hur AntiXssEncoder typ anges för ett ASP.NET program:

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

Konfigurationsinställningen i exemplet anger klassen AntiXssEncoder för att utföra all utdatakodning i programmet. Mer information finns i klassöversikten AntiXssEncoder .

Anteckningar till arvingar

När du skapar en anpassad kodarklass och åsidosätter basmetoderna för basklassen kan den härledda kodaren utlösa ett undantag från någon av de åsidosatta metoderna. I följande fall kan dock ett sådant undantag leda till oväntat beteende i ASP.NET:

  • Om ASP.NET återger en felsida som orsakas av ett ohanterat undantag som utlöstes från en anpassad kodare, försöker ASP.NET inte koda sina felutdata genom att anropa till den anpassade kodaren. Detta undviker rekursiva felvillkor.

  • När ASP.NET skickar HTTP-huvuden till IIS har ASP.NET ingen etablering för ohanterade undantag. Därför återges standardsidan ASP.NET fel (om konfigurationsinställningarna tillåter att den här sidan visas).

Konstruktorer

Name Description
HttpEncoder()

Initierar en ny instans av HttpEncoder klassen.

Egenskaper

Name Description
Current

Hämtar eller anger den HttpEncoder typ som ska användas i ett program.

Default

Hämtar en referens till standardkodaren för ASP.NET.

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
HeaderNameValueEncode(String, String, String, String)

Kodar ett rubriknamn och ett värde till en sträng som kan användas som http-huvud.

HtmlAttributeEncode(String, TextWriter)

Kodar ett inkommande värde i en sträng som kan infogas i ett HTML-attribut som avgränsas med enkla eller dubbla citattecken.

HtmlDecode(String, TextWriter)

Avkodar ett värde från en HTML-kodad sträng.

HtmlEncode(String, TextWriter)

Kodar en sträng till en HTML-kodad sträng.

JavaScriptStringEncode(String)

Kodar en sträng.

MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
UrlEncode(Byte[], Int32, Int32)

Kodar en matris med tecken som inte tillåts i en URL till en hexadecimal teckenentitetsmotsvarighet.

UrlPathEncode(String)

Kodar ett underavsnitt av en URL.

Gäller för

Se även