HttpEncoder Třída

Definice

Poskytuje logiku kódování a dekódování.

public ref class HttpEncoder
public class HttpEncoder
type HttpEncoder = class
Public Class HttpEncoder
Dědičnost
HttpEncoder
Odvozené

Poznámky

Třída obsahuje logiku kódování a dekódování, která je používána metodami ve třídách, jako jsou HttpUtility , HttpServerUtility a HttpResponseHeader .

Můžete dědit ze HttpEncoder třídy a přepsat její chování pro přizpůsobení výchozího chování kódování a dekódování ASP.NET. Potom nastavíte EncoderType vlastnost HttpRuntimeSection třídy pro konfiguraci vlastní třídy.

Vlastní třída pro kódování a dekódování, která je odvozena z, HttpEncoder může přepsat integrované chování kódování a dekódování ASP.NET nebo změnit pouze vybrané aspekty.

Můžete nakonfigurovat vlastní typ kódování pro v ASP.NET a nahradit nebo doplnit následující chování kódování:

  • Kódování HTML

  • Kódování atributů HTML

  • Kódování adresy URL

  • Kódování cesty URL

  • Název záhlaví protokolu HTTP a kódování hodnoty v hlavičce

Ve výchozím nastavení jsou aplikace ASP.NET nakonfigurované tak, aby používaly AntiXssEncoder typ pro všechna výstupní kódování.

Následující příklad ze souboru Web.config na úrovni aplikace ukazuje, jak AntiXssEncoder je nastaven typ pro aplikaci ASP.NET:

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

Nastavení konfigurace v příkladu nastavuje AntiXssEncoder třídu pro provádění všech výstupních kódování v aplikaci. Další informace naleznete v AntiXssEncoder přehledu třídy.

Poznámky pro dědice

Když vytvoříte vlastní třídu kodéru a přepíšete základní metody základní třídy, může odvozený kodér vyvolat výjimku z jakékoli přepsané metody. V následujících případech však vyvolání takové výjimky může způsobit neočekávané chování v ASP.NET:

– Pokud ASP.NET vykresluje chybovou stránku, která je způsobena neošetřenou výjimkou vyvolanou z vlastního kodéru, ASP.NET se nepokusí kódovat svůj chybový výstup voláním do vlastního kodéru. Tím se vyhnete rekurzivnímu chybovému stavu.

– Pokud ASP.NET odesílá hlavičky HTTP do služby IIS, ASP.NET nemá žádné zřízení pro neošetřené výjimky. Proto se bude vykreslovat standardní chybová stránka ASP.NET (Pokud nastavení konfigurace umožní zobrazení této stránky).

Konstruktory

HttpEncoder()

Inicializuje novou instanci HttpEncoder třídy.

Vlastnosti

Current

Získá nebo nastaví HttpEncoder typ, který se použije v aplikaci.

Default

Získá odkaz na výchozí kodér pro ASP.NET.

Metody

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.

(Zděděno od Object)
GetType()

Type Získá aktuální instanci.

(Zděděno od Object)
HeaderNameValueEncode(String, String, String, String)

Zakóduje název a hodnotu záhlaví do řetězce, který lze použít jako hlavičku protokolu HTTP.

HtmlAttributeEncode(String, TextWriter)

Zakóduje příchozí hodnotu do řetězce, který může být vložen do atributu HTML, který je oddělen pomocí jednoduchých nebo dvojitých uvozovek.

HtmlDecode(String, TextWriter)

Dekóduje hodnotu z řetězce kódovaného ve formátu HTML.

HtmlEncode(String, TextWriter)

Zakóduje řetězec do řetězce kódovaného ve formátu HTML.

JavaScriptStringEncode(String)

Zakóduje řetězec.

MemberwiseClone()

Vytvoří použádnou kopii aktuálního souboru Object.

(Zděděno od Object)
ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
UrlEncode(Byte[], Int32, Int32)

Zakóduje pole znaků, které nejsou povoleny v adrese URL na ekvivalent hexadecimální znakové entity.

UrlPathEncode(String)

Zakóduje dílčí část adresy URL.

Platí pro

Viz také