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

Definição

Namespace:
System.Web.Util
Assemblies:
System.Web.dll, System.Web.Services.dll

Codifica um nome de cabeçalho e um valor 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 esse método é retornado, contém o nome codificado a ser usado para um cabeçalho HTTP. Esse parâmetro é passado sem inicialização.

encodedHeaderValue
String

Quando esse método é retornado, contém o valor codificado a ser usado para um cabeçalho HTTP. Esse parâmetro é passado sem inicialização.

Comentários

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

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 em URL em um formato em %NN que os N caracteres representam valores hexadecimal.

  • O caractere ASCII 9 (o caractere de guia horizontal) não é codificado em URL.

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

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

    Note

    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 se headerValueencodedHeaderValue é null ou é uma cadeia de caracteres vazia. Da mesma forma, a implementação padrão retorna o valor de headerName se encodedHeaderNameheaderName é null ou é uma cadeia de caracteres vazia.

Aplica-se a