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

Definicja

Przestrzeń nazw:
System.Web.Util
Zestawy:
System.Web.dll, System.Web.Services.dll

Koduje nazwę i wartość nagłówka do 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 zostanie zwrócona, zawiera nazwę zakodowaną do użycia dla nagłówka HTTP. Ten parametr jest przekazywany niezainicjowany.

encodedHeaderValue
String

Gdy ta metoda zwróci wartość, zawiera zakodowaną wartość do użycia dla nagłówka HTTP. Ten parametr jest przekazywany niezainicjowany.

Uwagi

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

Metoda HeaderNameValueEncode używa następującej logiki do kodowania nazw nagłówków i wartości:

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

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

  • Znak ASCII 127 jest zakodowany jako %7F.

  • Wszystkie inne znaki nie są kodowane.

    Note

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

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

Dotyczy