HttpEncoder Klasse

Definition

Stellt Codierungs- und Decodierungslogik bereit.Provides encoding and decoding logic.

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

Hinweise

Die-Klasse enthält Codierungs-und Decodierungs Logik, die von Methoden HttpUtilityin HttpServerUtilityKlassen wie HttpResponseHeader, und verwendet wird.The class contains encoding and decoding logic that is used by methods in classes such as HttpUtility, HttpServerUtility, and HttpResponseHeader.

Sie können von der HttpEncoder -Klasse erben und das zugehörige Verhalten überschreiben, um das Standardverhalten für die Codierung und Decodierung von ASP.net anzupassen.You can inherit from the HttpEncoder class and override its behavior to customize the default encoding and decoding behavior of ASP.NET. Anschließend legen Sie die EncoderType -Eigenschaft HttpRuntimeSection der-Klasse fest, um die benutzerdefinierte Klasse zu konfigurieren.You then set the EncoderType property of the HttpRuntimeSection class to configure your custom class.

Eine benutzerdefinierte Klasse zum Codieren und decodieren HttpEncoder , die von abgeleitet wird, kann das integrierte ASP.net-Codierungs-und Decodierungs Verhalten überschreiben oder nur ausgewählte Aspekte ändern.A custom class for encoding and decoding that derives from HttpEncoder can override the built-in ASP.NET encoding and decoding behavior or change only selected aspects of it.

Sie können den benutzerdefinierten Codierungstyp für in ASP.net konfigurieren, um das folgende Codierungs Verhalten zu ersetzen oder zu ergänzen:You can configure the custom encoding type for in ASP.NET to replace or supplement the following encoding behavior:

  • HTML-CodierungHTML encoding

  • HTML-Attribut CodierungHTML attribute encoding

  • URL-CodierungURL encoding

  • URL-Pfad CodierungURL path encoding

  • HTTP-Header Name und Header Wert CodierungHTTP header name and header value encoding

Standardmäßig sind ASP.NET-Anwendungen so konfiguriert, dass AntiXssEncoder Sie den-Typ für alle Ausgabe Codierungen verwenden.By default, ASP.NET applications are configured to use the AntiXssEncoder type for all output encoding.

Das folgende Beispiel aus einer Web. config-Datei auf Anwendungsebene zeigt, AntiXssEncoder wie der-Typ für eine ASP.NET-Anwendung festgelegt wird:The following example from an application-level Web.config file shows how the AntiXssEncoder type is set for an ASP.NET application:

<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 Ausgabe Codierungen in der Anwendung durchgeführt werden.The configuration setting in the example sets the AntiXssEncoder class to perform all output encoding in the application. Weitere Informationen finden Sie in der AntiXssEncoder Übersicht über die-Klasse.For more information, see the AntiXssEncoder class overview.

Hinweise für Vererber

Wenn Sie eine benutzerdefinierte encoderklasse erstellen und die Basis Methoden der Basisklasse überschreiben, löst der abgeleitete Encoder möglicherweise eine Ausnahme von einer der überschriebenen Methoden aus.When you create a custom encoder class and override the base methods of the base class, the derived encoder might throw an exception from any of the overridden methods. In den folgenden Fällen kann das Auslösen einer solchen Ausnahme in ASP.net zu unerwartetem Verhalten führen:However, in the following cases throwing such an exception could lead to unexpected behavior in ASP.NET:

Wenn ASP.net eine Fehlerseite rendert, die durch eine nicht behandelte Ausnahme verursacht wird, die von einem benutzerdefinierten Encoder ausgelöst wurde, versucht ASP.net nicht, die Fehlerausgabe zu codieren, indem der benutzerdefinierte Encoder aufgerufen wird.- If ASP.NET is rendering an error page that is caused by an unhandled exception that was thrown from a custom encoder, ASP.NET does not attempt to encode its error output by calling into the custom encoder. Dadurch werden rekursive Fehlerzustände vermieden.This avoids recursive error conditions.

-Wenn ASP.NET HTTP-Header an IIS sendet, verfügt ASP.net nicht über die Bereitstellung von nicht behandelten Ausnahmen.- When ASP.NET is sending HTTP headers to IIS, ASP.NET has no provision for unhandled exceptions. Daher wird die ASP.NET-Standard Fehlerseite gerendert (wenn die Konfigurationseinstellungen die Anzeige dieser Seite erlauben).Therefore, the standard ASP.NET error page will be rendered (if configuration settings allows this page to be displayed).

Konstruktoren

HttpEncoder()

Initialisiert eine neue Instanz der HttpEncoder-Klasse.Initializes a new instance of the HttpEncoder class.

Eigenschaften

Current

Ruft den HttpEncoder-Typ ab, der in einer Anwendung verwendet wird, oder legt ihn fest.Gets or set the HttpEncoder type that will be used in an application.

Default

Ruft einen Verweis auf den Standardcodierer für ASP.NET ab.Gets a reference to the default encoder for ASP.NET.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Codiert einen Headernamen und einen Wert in eine Zeichenfolge, die als HTTP-Header verwendet werden kann.Encodes a header name and value into a string that can be used as an HTTP header.

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.Encodes an incoming value into a string that can be inserted into an HTML attribute that is delimited by using single or double quotation marks.

HtmlDecode(String, TextWriter)

Hebt die Codierung eines Werts von einer HTML-codierten Zeichenfolge auf.Decodes a value from an HTML-encoded string.

HtmlEncode(String, TextWriter)

Codiert eine Zeichenfolge in eine HTML-codierte Zeichenfolge.Encodes a string into an HTML-encoded string.

JavaScriptStringEncode(String)

Codiert eine Zeichenfolge.Encodes a string.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

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

Codiert ein Array von Zeichen, die in einer URL nicht zulässig sind, in eine hexadezimale Zeichenentitätsentsprechung.Encodes an array of characters that are not allowed in a URL into a hexadecimal character-entity equivalent.

UrlPathEncode(String)

Codiert einen Unterabschnitt einer URL.Encodes a subsection of a URL.

Gilt für:

Siehe auch