HttpEncoder.HeaderNameValueEncode(String, String, String, String) Метод

Определение

Кодирует имя и значение заголовка в строку, которая может быть использована в 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)

Параметры

headerName
String

Имя HTTP-заголовка, которое необходимо закодировать.

headerValue
String

Значение HTTP-заголовка, которое необходимо закодировать.

encodedHeaderName
String

Этот метод возвращает кодированное имя для использования в HTTP-заголовке. Этот параметр передается неинициализированным.

encodedHeaderValue
String

Этот метод возвращает кодированное значение для использования в HTTP-заголовке. Этот параметр передается неинициализированным.

Комментарии

HeaderNameValueEncodeМетод принимает входные строки из headerName параметров и headerValue и кодирует их. Закодированные значения возвращаются в виде параметров out.

HeaderNameValueEncodeМетод использует следующую логику для кодирования имен и значений заголовков:

  • Все символы, значение Юникода которых меньше, чем символ ASCII 32, за исключением символа ASCII 9, кодируются в формате URL в формат, в %NN котором N символы представляют шестнадцатеричные значения.

  • Символ ASCII 9 (символ табуляции по горизонтали) не кодируется в URL-адресе.

  • Символ ASCII 127 кодируется как %7F .

  • Все остальные символы не кодируются.

    Примечание

    Несмотря на то, что этот метод можно использовать для значений Юникода, он обычно используется для значений в диапазоне ASCII.

Реализация метода по умолчанию HeaderNameValueEncode возвращает значение headerValue в, encodedHeaderValue Если headerValue равно null или является пустой строкой. Аналогичным образом, реализация по умолчанию возвращает значение headerName в, encodedHeaderName Если headerName равно null или является пустой строкой.

Применяется к