Compartir a través de


HttpEncoder Clase

Definición

Proporciona lógica de codificación y descodificación.

public ref class HttpEncoder
public class HttpEncoder
type HttpEncoder = class
Public Class HttpEncoder
Herencia
HttpEncoder
Derivado

Comentarios

La clase contiene la lógica de codificación y descodificación que usan los métodos en clases como HttpUtility, HttpServerUtilityy HttpResponseHeader.

Puede heredar de la HttpEncoder clase e invalidar su comportamiento para personalizar el comportamiento predeterminado de codificación y descodificación de ASP.NET. A continuación, establezca la EncoderType propiedad de la HttpRuntimeSection clase para configurar la clase personalizada.

Una clase personalizada para codificar y descodificar que deriva de HttpEncoder puede invalidar el comportamiento de codificación y descodificación integrados ASP.NET o cambiar solo los aspectos seleccionados.

Puede configurar el tipo de codificación personalizado para en ASP.NET reemplazar o complementar el siguiente comportamiento de codificación:

  • Codificación HTML

  • Codificación de atributos HTML

  • Codificación de direcciones URL

  • Codificación de ruta de acceso url

  • Codificación de nombre y valor de encabezado HTTP

De forma predeterminada, ASP.NET aplicaciones están configuradas para usar el AntiXssEncoder tipo para toda la codificación de salida.

En el ejemplo siguiente de un archivo de Web.config de nivel de aplicación se muestra cómo se establece el AntiXssEncoder tipo para una aplicación de ASP.NET:

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

El valor de configuración del ejemplo establece la AntiXssEncoder clase para realizar toda la codificación de salida en la aplicación. Para obtener más información, consulte la información general de la AntiXssEncoder clase.

Notas a los desarrolladores de herederos

Al crear una clase de codificador personalizada e invalidar los métodos base de la clase base, el codificador derivado podría producir una excepción de cualquiera de los métodos invalidados. Sin embargo, en los siguientes casos, producir esta excepción podría provocar un comportamiento inesperado en ASP.NET:

  • Si ASP.NET representa una página de error causada por una excepción no controlada que se produjo desde un codificador personalizado, ASP.NET no intenta codificar su salida de error llamando al codificador personalizado. Esto evita condiciones de error recursivas.

  • Cuando ASP.NET envía encabezados HTTP a IIS, ASP.NET no tiene aprovisionamiento para excepciones no controladas. Por lo tanto, se representará la página de error estándar ASP.NET (si la configuración permite mostrar esta página).

Constructores

HttpEncoder()

Inicializa una nueva instancia de la clase HttpEncoder.

Propiedades

Current

Obtiene o establece el tipo de HttpEncoder que se usará en una aplicación.

Default

Obtiene una referencia al codificador predeterminado de ASP.NET.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
HeaderNameValueEncode(String, String, String, String)

Codifica el nombre y el valor de un encabezado en una cadena que se puede usar como encabezado HTTP.

HtmlAttributeEncode(String, TextWriter)

Codifica un valor de entrada en una cadena que se puede insertar en un atributo HTML delimitado con comillas simples o dobles.

HtmlDecode(String, TextWriter)

Descodifica un valor de una cadena con código HTML.

HtmlEncode(String, TextWriter)

Codifica una cadena en una cadena HTML.

JavaScriptStringEncode(String)

Codifica una cadena.

MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
UrlEncode(Byte[], Int32, Int32)

Codifica una matriz de caracteres no permitidos en las direcciones URL en un equivalente de la entidad de caracteres hexadecimales.

UrlPathEncode(String)

Codifica una subsección de una dirección URL.

Se aplica a

Consulte también