Condividi tramite

HttpEncoder Classe

Definizione

Spazio dei nomi:
System.Web.Util
Assembly:
System.Web.dll, System.Web.Services.dll

Fornisce la logica di codifica e decodifica.

public ref class HttpEncoder
public class HttpEncoder
type HttpEncoder = class
Public Class HttpEncoder
Ereditarietà
Object
HttpEncoder
Derivato

Commenti

La classe contiene la logica di codifica e decodifica usata dai metodi nelle classi, ad HttpUtilityesempio , HttpServerUtilitye HttpResponseHeader.

È possibile ereditare dalla HttpEncoder classe ed eseguire l'override del relativo comportamento per personalizzare il comportamento di codifica e decodifica predefinito di ASP.NET. Impostare quindi la EncoderType proprietà della classe per configurare la HttpRuntimeSection classe personalizzata.

Una classe personalizzata per la codifica e la decodifica che deriva da HttpEncoder può eseguire l'override della codifica ASP.NET predefinita e del comportamento di decodifica o modificare solo gli aspetti selezionati.

È possibile configurare il tipo di codifica personalizzato per in ASP.NET per sostituire o integrare il comportamento di codifica seguente:

  • Codifica HTML

  • Codifica degli attributi HTML

  • Codifica URL

  • Codifica del percorso URL

  • Codifica del nome e del valore dell'intestazione HTTP

Per impostazione predefinita, le applicazioni ASP.NET sono configurate per l'uso del tipo per tutta la AntiXssEncoder codifica di output.

L'esempio seguente di un file di Web.config a livello di applicazione mostra come viene impostato il AntiXssEncoder tipo per un'applicazione ASP.NET:

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

L'impostazione di configurazione nell'esempio imposta la AntiXssEncoder classe per eseguire tutta la codifica di output nell'applicazione. Per altre informazioni, vedere la panoramica della AntiXssEncoder classe.

Note per gli eredi

Quando si crea una classe di codificatore personalizzata ed si esegue l'override dei metodi di base della classe base, il codificatore derivato potrebbe generare un'eccezione da uno dei metodi sottoposti a override. Nei casi seguenti, tuttavia, la generazione di un'eccezione di questo tipo potrebbe causare un comportamento imprevisto in ASP.NET:

  • Se ASP.NET esegue il rendering di una pagina di errore causata da un'eccezione non gestita generata da un codificatore personalizzato, ASP.NET non tenta di codificare l'output degli errori chiamando nel codificatore personalizzato. In questo modo si evitano condizioni di errore ricorsive.

  • Quando ASP.NET invia intestazioni HTTP a IIS, ASP.NET non ha alcun provisioning per le eccezioni non gestite. Di conseguenza, verrà eseguito il rendering della pagina di errore standard ASP.NET (se le impostazioni di configurazione consentono di visualizzare questa pagina).

Costruttori

Nome Descrizione
HttpEncoder()

Inizializza una nuova istanza della classe HttpEncoder.

Proprietà

Nome Descrizione
Current

Ottiene o imposta il HttpEncoder tipo che verrà utilizzato in un'applicazione.
Default

Ottiene un riferimento al codificatore predefinito per ASP.NET.

Metodi

Nome Descrizione
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
HeaderNameValueEncode(String, String, String, String)

Codifica un nome di intestazione e un valore in una stringa che può essere usata come intestazione HTTP.
HtmlAttributeEncode(String, TextWriter)

Codifica un valore in ingresso in una stringa che può essere inserita in un attributo HTML delimitato tramite virgolette singole o doppie.
HtmlDecode(String, TextWriter)

Decodifica un valore da una stringa con codifica HTML.
HtmlEncode(String, TextWriter)

Codifica una stringa in una stringa con codifica HTML.
JavaScriptStringEncode(String)

Codifica una stringa.
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
UrlEncode(Byte[], Int32, Int32)

Codifica una matrice di caratteri non consentiti in un URL in un equivalente di entità carattere esadecimale.
UrlPathEncode(String)

Codifica una sottosezione di un URL.

Si applica a

Vedi anche