HttpEncoder Classe

  • Riferimento

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 classe ed eseguire l'override del HttpEncoder 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 predefinita ASP.NET e del comportamento di decodifica o di modificarne 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 AntiXssEncoder tipo per tutte le codifiche di output.

Nell'esempio seguente di un file di Web.config a livello di applicazione viene illustrato 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 codificatore personalizzata ed si eseguono 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 tale eccezione 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 dispone di provisioning per le eccezioni non gestite. Verrà pertanto eseguito il rendering della pagina di errore standard ASP.NET (se le impostazioni di configurazione consentono la visualizzazione di questa pagina).

Costruttori

HttpEncoder()

Inizializza una nuova istanza della classe HttpEncoder.

Proprietà

Current

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

Ottiene un riferimento al codificatore predefinito per ASP.NET.

Metodi

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 l'oggetto Type dell'istanza corrente.

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

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

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

Decodifica un valore da una stringa codificata in formato HTML.
HtmlEncode(String, TextWriter)

Codifica una stringa in una stringa codificata in HTML.
JavaScriptStringEncode(String)

Esegue la codifica di una stringa.
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(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'entità carattere esadecimale equivalente.
UrlPathEncode(String)

Codifica una sottosezione di un URL.

Si applica a

Vedi anche