HttpEncoder.HeaderNameValueEncode(String, String, String, String) Metode

Definisi

Ruang nama:

System.Web.Util

Rakitan:

System.Web.dll, System.Web.Services.dll

Mengodekan nama header dan nilai ke dalam string yang dapat digunakan sebagai header HTTP.

protected public:
 virtual void HeaderNameValueEncode(System::String ^ headerName, System::String ^ headerValue, [Runtime::InteropServices::Out] System::String ^ % encodedHeaderName, [Runtime::InteropServices::Out] System::String ^ % encodedHeaderValue);

protected internal virtual void HeaderNameValueEncode(string headerName, string headerValue, out string encodedHeaderName, out string encodedHeaderValue);

abstract member HeaderNameValueEncode : string * string * string * string -> unit
override this.HeaderNameValueEncode : string * string * string * string -> unit

Protected Friend Overridable Sub HeaderNameValueEncode (headerName As String, headerValue As String, ByRef encodedHeaderName As String, ByRef encodedHeaderValue As String)

Parameter

headerName

String

Nama header HTTP untuk dikodekan.

headerValue

String

Nilai header HTTP untuk dikodekan.

encodedHeaderName

String

Ketika metode ini kembali, berisi nama yang dikodekan untuk digunakan untuk header HTTP. Parameter ini diteruskan tanpa diinisialisasi.

encodedHeaderValue

String

Ketika metode ini kembali, berisi nilai yang dikodekan untuk digunakan untuk header HTTP. Parameter ini diteruskan tanpa diinisialisasi.

Keterangan

Metode ini HeaderNameValueEncode mengambil string input dari headerName parameter dan headerValue dan mengodekannya. Nilai yang dikodekan dikembalikan sebagai parameter keluar.

Metode ini HeaderNameValueEncode menggunakan logika berikut untuk mengodekan nama dan nilai header:

• Semua karakter yang nilai Unicode-nya kurang dari karakter ASCII 32, kecuali karakter ASCII 9, dikodekan URL ke dalam format %NN di mana N karakter mewakili nilai heksadesimal.

• Karakter ASCII 9 (karakter tab horizontal) tidak dikodekan URL.

• Karakter ASCII 127 dikodekan sebagai %7F.

• Semua karakter lain tidak dikodekan.

  Note

  Meskipun metode ini dapat digunakan untuk nilai Unicode, metode ini biasanya digunakan untuk nilai dalam rentang ASCII.

Implementasi HeaderNameValueEncode default metode mengembalikan nilai headerValue dalam encodedHeaderValue jika headerValue adalah null atau adalah string kosong. Demikian pula, implementasi default mengembalikan nilai headerName dalam encodedHeaderName jika headerName adalah null atau adalah string kosong.