Freigeben über

HttpEncoder Klasse

Definition

Namespace:
System.Web.Util
Assemblys:
System.Web.dll, System.Web.Services.dll

Stellt Codierungs- und Decodierungslogik bereit.

public ref class HttpEncoder
public class HttpEncoder
type HttpEncoder = class
Public Class HttpEncoder
Vererbung
Object
HttpEncoder
Abgeleitet

Hinweise

Die Klasse enthält Codierungs- und Decodierungslogik, die von Methoden in Klassen wie HttpUtility, , HttpServerUtilityund HttpResponseHeader.

Sie können von der HttpEncoder Klasse erben und ihr Verhalten außer Kraft setzen, um das Standardcodierungs- und Decodierungsverhalten von ASP.NET anzupassen. Anschließend legen Sie die EncoderType Eigenschaft der HttpRuntimeSection Klasse fest, um Ihre benutzerdefinierte Klasse zu konfigurieren.

Eine benutzerdefinierte Klasse zum Codieren und Decodieren, von HttpEncoder der abgeleitet wird, kann das integrierte ASP.NET Codierungs- und Decodierungsverhalten überschreiben oder nur ausgewählte Aspekte davon ändern.

Sie können den benutzerdefinierten Codierungstyp für ASP.NET konfigurieren, um das folgende Codierungsverhalten zu ersetzen oder zu ergänzen:

  • HTML-Codierung

  • HTML-Attributcodierung

  • URL-Codierung

  • URL-Pfadcodierung

  • HTTP-Headername und Headerwertcodierung

Standardmäßig sind ASP.NET Anwendungen so konfiguriert, dass der AntiXssEncoder Typ für alle Ausgabecodierungen verwendet wird.

Das folgende Beispiel aus einer Web.config Datei auf Anwendungsebene zeigt, wie der AntiXssEncoder Typ für eine ASP.NET Anwendung festgelegt wird:

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

Die Konfigurationseinstellung im Beispiel legt die AntiXssEncoder Klasse so fest, dass alle Ausgabecodierungen in der Anwendung ausgeführt werden. Weitere Informationen finden Sie in der AntiXssEncoder Klassenübersicht.

Hinweise für Vererber

Wenn Sie eine benutzerdefinierte Encoderklasse erstellen und die Basismethoden der Basisklasse außer Kraft setzen, löst der abgeleitete Encoder möglicherweise eine Ausnahme von einer der überschriebenen Methoden aus. In den folgenden Fällen kann das Auslösen einer solchen Ausnahme jedoch zu unerwartetem Verhalten in ASP.NET führen:

  • Wenn ASP.NET eine Fehlerseite rendert, die durch eine unbehandelte Ausnahme verursacht wird, die von einem benutzerdefinierten Encoder ausgelöst wurde, versucht ASP.NET nicht, die Fehlerausgabe durch Aufrufen des benutzerdefinierten Encoders zu codieren. Dadurch werden rekursive Fehlerbedingungen vermieden.

  • Wenn ASP.NET HTTP-Header an IIS sendet, hat ASP.NET keine Bereitstellung für unbehandelte Ausnahmen. Daher wird die Standardmäßige ASP.NET Fehlerseite gerendert (wenn Konfigurationseinstellungen die Anzeige dieser Seite ermöglichen).

Konstruktoren

Name Beschreibung
HttpEncoder()

Initialisiert eine neue Instanz der HttpEncoder-Klasse.

Eigenschaften

Name Beschreibung
Current

Ruft den Typ ab, der HttpEncoder in einer Anwendung verwendet wird, oder legt diesen fest.
Default

Ruft einen Verweis auf den Standard-Encoder für ASP.NET ab.

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
HeaderNameValueEncode(String, String, String, String)

Codiert einen Headernamen und -wert in eine Zeichenfolge, die als HTTP-Header verwendet werden kann.
HtmlAttributeEncode(String, TextWriter)

Codiert einen eingehenden Wert in eine Zeichenfolge, die in ein HTML-Attribut eingefügt werden kann, das durch einfache oder doppelte Anführungszeichen getrennt wird.
HtmlDecode(String, TextWriter)

Decodiert einen Wert aus einer HTML-codierten Zeichenfolge.
HtmlEncode(String, TextWriter)

Codiert eine Zeichenfolge in eine HTML-codierte Zeichenfolge.
JavaScriptStringEncode(String)

Codiert eine Zeichenfolge.
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
UrlEncode(Byte[], Int32, Int32)

Codiert ein Array von Zeichen, die in einer URL nicht zulässig sind, in eine Hexadezimalzeichenentitätsentsprechung.
UrlPathEncode(String)

Codiert einen Unterabschnitt einer URL.

Gilt für:

Weitere Informationen