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

Definição

Namespace:

System.Web.Util

Assemblies:

System.Web.dll, System.Web.Services.dll

Assembly:

System.Web.Services.dll

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.