WebUtility.UrlEncodeToBytes(Byte[], Int32, Int32) Método

Definición

Espacio de nombres:
System.Net
Ensamblados:
System.dll, System.Runtime.Extensions.dll
Ensamblados:
netstandard.dll, System.Runtime.dll
Ensamblado:
System.Runtime.Extensions.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll
Source:
WebUtility.cs
Source:
WebUtility.cs
Source:
WebUtility.cs
Source:
WebUtility.cs
Source:
WebUtility.cs

Convierte una matriz de bytes en una matriz de bytes con codificación URL.

public:
 static cli::array <System::Byte> ^ UrlEncodeToBytes(cli::array <System::Byte> ^ value, int offset, int count);
public static byte[] UrlEncodeToBytes(byte[] value, int offset, int count);
public static byte[]? UrlEncodeToBytes(byte[]? value, int offset, int count);
static member UrlEncodeToBytes : byte[] * int * int -> byte[]
Public Shared Function UrlEncodeToBytes (value As Byte(), offset As Integer, count As Integer) As Byte()

Parámetros

value
Byte[]

Matriz Byte en codificación URL.

offset
Int32

Desplazamiento, en bytes, desde el principio de la Byte matriz que se va a codificar.

count
Int32

Recuento, en bytes, para codificar desde la Byte matriz.

Devoluciones

Byte[]

Matriz codificada Byte .

Comentarios

Si se pasan caracteres como espacios en blanco y puntuación en una secuencia HTTP, es posible que se malinterpreten en el extremo receptor. La codificación url reemplaza los caracteres que no se permiten en una dirección URL por equivalentes de entidad de caracteres que constan de secuencias de escape hexadecimales. Se espera que la cadena convertida se ajuste al formato UTF-8.

La codificación url reemplaza todos los códigos de caracteres, excepto las letras, los números y los siguientes caracteres de puntuación:

  • - (signo menos)

  • _ (subrayado)

  • . (punto)

  • ! (signo de exclamación)

  • * (asterisco)

  • ' (comillas simples)

  • ( y ) (paréntesis de apertura y cierre)

Cada carácter ' ( espacio) se convierte en un + carácter (más).

Note

Reemplazar ' (espacio) por un signo '+' (más) solo se espera en la parte de consulta del URI (por convención, no por estándar) o en application/x-www-form-urlencoded contenido HTTP. Por otra parte, la lista mencionada anteriormente de caracteres que no se reemplaza no se corresponde con la especificación de dirección URL ni el URI RFC 3986. Use EscapeDataString para la transformación compatible con RFC.

Por ejemplo, cuando se inserta en un bloque de texto que se va a transmitir en una dirección URL, los caracteres < y > se codifican como %3c y %3e.

El UrlDecodeToBytes método invierte la codificación.

Se aplica a