HttpEncoder.HeaderNameValueEncode(String, String, String, String) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zakóduje název a hodnotu záhlaví do řetězce, který lze použít jako hlavičku protokolu 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
Název hlavičky protokolu HTTP, který se má zakódovat
- headerValue
- String
Hodnota hlavičky protokolu HTTP, která se má zakódovat
- encodedHeaderName
- String
Až tato metoda vrátí, obsahuje kódovaný název, který se má použít pro hlavičku protokolu HTTP. Tento parametr se předává neinicializovaný.
- encodedHeaderValue
- String
Až tato metoda vrátí, obsahuje zakódovanou hodnotu, která se má použít pro hlavičku protokolu HTTP. Tento parametr se předává neinicializovaný.
Poznámky
HeaderNameValueEncodeMetoda přebírá vstupní řetězce z headerName
parametrů a headerValue
a kóduje je. Zakódované hodnoty jsou vraceny jako výstupní parametry.
HeaderNameValueEncodeMetoda používá následující logiku pro kódování názvů a hodnot hlaviček:
Všechny znaky, jejichž hodnota Unicode je menší než ASCII znak 32, s výjimkou znaku 9 ASCII, jsou zakódovány pomocí adresy URL do formátu,
%NN
kdeN
znaky představují hexadecimální hodnoty.Znak ASCII 9 (vodorovný znak tabulátoru) není kódovaný na adrese URL.
Znak 127 ASCII je kódován jako
%7F
.Všechny ostatní znaky nejsou zakódovány.
Poznámka
I když tuto metodu lze použít pro hodnoty Unicode, obvykle se používá pro hodnoty v rozsahu ASCII.
Výchozí implementace HeaderNameValueEncode metody vrátí hodnotu headerValue
v, encodedHeaderValue
Pokud headerValue
je null
, nebo je prázdný řetězec. Podobně výchozí implementace vrací hodnotu headerName
v, encodedHeaderName
Pokud headerName
je null
, nebo je prázdný řetězec.