Bagikan melalui

HttpEncoder Kelas

Definisi

Ruang nama:
System.Web.Util
Rakitan:
System.Web.dll, System.Web.Services.dll

Menyediakan logika pengodean dan pendekodean.

public ref class HttpEncoder
public class HttpEncoder
type HttpEncoder = class
Public Class HttpEncoder
Warisan
Object
HttpEncoder
Turunan

Keterangan

Kelas berisi logika pengodean dan pendekodean yang digunakan oleh metode di kelas seperti HttpUtility, , HttpServerUtilitydan HttpResponseHeader.

Anda dapat mewarisi dari HttpEncoder kelas dan mengambil alih perilakunya untuk menyesuaikan perilaku pengodean dan pendekodean default ASP.NET. Anda kemudian mengatur EncoderType properti HttpRuntimeSection kelas untuk mengonfigurasi kelas kustom Anda.

Kelas kustom untuk pengodean dan pendekodean yang berasal dari HttpEncoder dapat menimpa perilaku pengodean dan dekode ASP.NET bawaan atau hanya mengubah aspek yang dipilih.

Anda dapat mengonfigurasi jenis pengodean kustom untuk di ASP.NET untuk mengganti atau melengkapi perilaku pengodean berikut:

  • Pengodean HTML

  • Pengodean atribut HTML

  • Pengodean URL

  • Pengodean jalur URL

  • Nama header HTTP dan pengodean nilai header

Secara default, aplikasi ASP.NET dikonfigurasi untuk menggunakan AntiXssEncoder jenis untuk semua pengodean output.

Contoh berikut dari file Web.config tingkat aplikasi menunjukkan bagaimana AntiXssEncoder jenis diatur untuk aplikasi ASP.NET:

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

Pengaturan konfigurasi dalam contoh mengatur AntiXssEncoder kelas untuk melakukan semua pengodean output dalam aplikasi. Untuk informasi selengkapnya, lihat gambaran AntiXssEncoder umum kelas.

Catatan Bagi Inheritor

Saat Anda membuat kelas encoder kustom dan mengambil alih metode dasar kelas dasar, encoder turunan mungkin melemparkan pengecualian dari salah satu metode yang ditimpa. Namun, dalam kasus berikut yang melemparkan pengecualian tersebut dapat menyebabkan perilaku tak terduga dalam ASP.NET:

  • Jika ASP.NET merender halaman kesalahan yang disebabkan oleh pengecualian yang tidak tertangani yang dilemparkan dari encoder kustom, ASP.NET tidak mencoba mengodekan output kesalahannya dengan memanggil ke encoder kustom. Ini menghindari kondisi kesalahan rekursif.

  • Ketika ASP.NET mengirim header HTTP ke IIS, ASP.NET tidak memiliki ketentuan untuk pengecualian yang tidak tertangani. Oleh karena itu, halaman kesalahan ASP.NET standar akan dirender (jika pengaturan konfigurasi memungkinkan halaman ini ditampilkan).

Konstruktor

Nama Deskripsi
HttpEncoder()

Menginisialisasi instans baru dari kelas HttpEncoder.

Properti

Nama Deskripsi
Current

Mendapatkan atau mengatur HttpEncoder jenis yang akan digunakan dalam aplikasi.
Default

Mendapatkan referensi ke encoder default untuk ASP.NET.

Metode

Nama Deskripsi
Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan Type instans saat ini.

(Diperoleh dari Object)
HeaderNameValueEncode(String, String, String, String)

Mengodekan nama header dan nilai ke dalam string yang dapat digunakan sebagai header HTTP.
HtmlAttributeEncode(String, TextWriter)

Mengodekan nilai masuk ke dalam string yang dapat dimasukkan ke dalam atribut HTML yang dibatasi dengan menggunakan tanda kutip tunggal atau ganda.
HtmlDecode(String, TextWriter)

Mendekode nilai dari string yang dikodekan HTML.
HtmlEncode(String, TextWriter)

Mengodekan string ke dalam string yang dikodekan HTML.
JavaScriptStringEncode(String)

Mengodekan string.
MemberwiseClone()

Membuat salinan dangkal dari Objectsaat ini.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)
UrlEncode(Byte[], Int32, Int32)

Mengodekan array karakter yang tidak diizinkan dalam URL ke dalam entitas karakter heksadesimal yang setara.
UrlPathEncode(String)

Mengodekan sub-bagian URL.

Berlaku untuk

Lihat juga