Compartilhar via


HttpEncoder.HeaderNameValueEncode(String, String, String, String) Método

Definição

Codifica um nome de cabeçalho em uma cadeia de caracteres que pode ser usada como um cabeçalho 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)

Parâmetros

headerName
String

O nome do cabeçalho HTTP a ser codificado.

headerValue
String

O valor do cabeçalho HTTP a ser codificado.

encodedHeaderName
String

Quando este método retorna, contém o nome codificado a ser usado para um cabeçalho HTTP. Este parâmetro é passado não inicializado.

encodedHeaderValue
String

Quando este método retorna, contém o valor codificado a ser usado para um cabeçalho HTTP. Este parâmetro é passado não inicializado.

Comentários

O HeaderNameValueEncode método usa cadeias de caracteres de entrada dos headerName headerValue parâmetros e e os codifica. Os valores codificados são retornados como parâmetros de saída.

O HeaderNameValueEncode método usa a seguinte lógica para codificar nomes e valores de cabeçalho:

  • Todos os caracteres cujo valor Unicode é menor que o caractere ASCII 32, exceto o caractere ASCII 9, são codificados por URL em um formato de %NN onde os N caracteres representam valores hexadecimais.

  • O caractere ASCII 9 (o caractere de tabulação horizontal) não é codificado por URL.

  • O caractere ASCII 127 é codificado como %7F .

  • Todos os outros caracteres não são codificados.

    Observação

    Embora esse método possa ser usado para valores Unicode, ele normalmente é usado para valores no intervalo ASCII.

A implementação padrão do HeaderNameValueEncode método retorna o valor de headerValue em encodedHeaderValue If headerValue é null ou é uma cadeia de caracteres vazia. Da mesma forma, a implementação padrão retorna o valor de headerName em encodedHeaderName If headerName é null ou é uma cadeia de caracteres vazia.

Aplica-se a