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
или является пустой строкой.