HttpEncoder Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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. |