HttpEncoder.HeaderNameValueEncode(String, String, String, String) Metoda

Definicja

Przestrzeń nazw:

System.Web.Util

Zestawy:

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

Zestaw:

System.Web.Services.dll

Koduje nazwę nagłówka i wartość w postaci ciągu, który może być używany jako nagłówek 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)

Parametry

headerName

String

Nazwa nagłówka HTTP do zakodowania.

headerValue

String

Wartość nagłówka HTTP do zakodowania.

encodedHeaderName

String

Gdy ta metoda zwraca, zawiera zakodowaną nazwę, która ma być używana dla nagłówka HTTP. Ten parametr jest przekazywany jako niezainicjowany.

encodedHeaderValue

String

Gdy ta metoda zwraca, zawiera zakodowaną wartość używaną dla nagłówka HTTP. Ten parametr jest przekazywany jako niezainicjowany.

Uwagi

HeaderNameValueEncodeMetoda pobiera ciągi wejściowe z headerName headerValue parametrów i koduje je. Zakodowane wartości są zwracane jako parametry out.

HeaderNameValueEncodeMetoda używa następującej logiki do kodowania nazw i wartości nagłówka:

• Wszystkie znaki, których wartość Unicode jest mniejsza niż ASCII znak 32, z wyjątkiem ASCII znak 9, są kodowane w adresie URL w formacie, w %NN którym N znaki reprezentują wartości szesnastkowe.

• Znak ASCII 9 (znak tabulacji poziomej) nie jest zakodowany w adresie URL.

• Znak ASCII 127 jest zakodowany jako %7F .

• Wszystkie inne znaki nie są kodowane.

  Uwaga

  Chociaż ta metoda może być używana w przypadku wartości Unicode, zazwyczaj jest używana w przypadku wartości w zakresie ASCII.

Domyślna implementacja HeaderNameValueEncode metody zwraca wartość headerValue w encodedHeaderValue headerValue null parametrze if is lub jest pustym ciągiem. Podobnie implementacja domyślna zwraca wartość headerName w encodedHeaderName headerName null parametrze if is lub jest pustym ciągiem.