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

Definição

Espaço de Nomes:
System.Net
Assemblagens:
System.dll, System.Runtime.Extensions.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.Extensions.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll
Origem:
WebUtility.cs
Origem:
WebUtility.cs
Origem:
WebUtility.cs
Origem:
WebUtility.cs
Origem:
WebUtility.cs

Converte um array de bytes num array de bytes codificado por 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[]

O Byte array para codificar URL.

offset
Int32

O deslocamento, em bytes, desde o início do Byte array para codificar.

count
Int32

A contagem, em bytes, para codificar a partir do Byte array.

Devoluções

Byte[]

Um array codificado Byte .

Observações

Se caracteres como espaços em branco e pontuação forem passados num fluxo HTTP, podem ser mal interpretados na parte receptora. A codificação de URL substitui caracteres que não são permitidos numa URL por equivalentes entidade de carácter consistindo em sequências de escape hexadecimais. Espera-se que a cadeia convertida cumpra o formato UTF-8.

A codificação URL substitui todos os códigos de caracteres, exceto letras, números e os seguintes caracteres de pontuação:

  • - (sinal de menos)

  • _ (sublinhado)

  • . (ponto final)

  • ! (ponto de exclamação)

  • * (asterisco)

  • ' (aspas simples)

  • ( e ) (parênteses de abertura e fecho)

Cada carácter ' ' (espaço) é convertido num + carácter (mais).

Note

Substituir ' ' (espaço) por um sinal '+' (mais) é esperado apenas na parte de consulta do URI (por convenção, não por padrão) ou no application/x-www-form-urlencoded conteúdo HTTP. Além disso, a lista acima mencionada de caracteres que não são substituídos não corresponde nem à especificação de URL nem ao URI RFC 3986. Use EscapeDataString para transformação compatível com RFC.

Por exemplo, quando incorporados num bloco de texto a ser transmitido numa URL, os caracteres < e > são codificados como %3c e %3e.

O UrlDecodeToBytes método inverte a codificação.

Aplica-se a