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

Definición

Espacio de nombres:

System.Web.Util

Ensamblados:

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

Codifica el nombre y el valor de un encabezado en una cadena que se puede usar como encabezado 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

Nombre del encabezado HTTP que se va a codificar.

headerValue

String

Valor de encabezado HTTP que se va a codificar.

encodedHeaderName

String

Cuando este método devuelve un valor, contiene el nombre codificado que se va a usar para un encabezado HTTP. Este parámetro se pasa sin inicializar.

encodedHeaderValue

String

Cuando este método devuelve un valor, contiene el valor codificado que se va a usar para un encabezado HTTP. Este parámetro se pasa sin inicializar.

Comentarios

El HeaderNameValueEncode método toma cadenas de entrada de los headerName parámetros y y headerValue las codifica. Los valores codificados se devuelven como parámetros out.

El HeaderNameValueEncode método usa la siguiente lógica para codificar los nombres y valores de encabezado:

• Todos los caracteres cuyo valor Unicode es menor que el carácter ASCII 32, excepto el carácter ASCII 9, están codificados por url en un formato de %NN donde los N caracteres representan valores hexadecimales.

• El carácter ASCII 9 (el carácter de tabulación horizontal) no tiene codificación URL.

• El carácter ASCII 127 se codifica como %7F.

• Todos los demás caracteres no están codificados.

  Nota

  Aunque este método se puede usar para los valores Unicode, normalmente se usa para los valores del intervalo ASCII.

La implementación predeterminada del HeaderNameValueEncode método devuelve el valor de headerValue en encodedHeaderValue si headerValue es null o es una cadena vacía. De forma similar, la implementación predeterminada devuelve el valor de headerName en encodedHeaderName si headerName es null o es una cadena vacía.