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

Definição

Namespace:

System.Net

Assembly:

System.Runtime.dll

Origem:

WebUtility.cs

Converte uma matriz de bytes em uma matriz de bytes codificada em 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);

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[]

A matriz Byte a ser codificada em URL.

offset

Int32

O deslocamento, em bytes, do início da matriz Byte a ser codificado.

count

Int32

A contagem, em bytes, a ser codificada da matriz Byte.

Retornos

Byte[]

Uma matriz Byte codificada.

Comentários

Se caracteres como espaços em branco e pontuação forem passados em um fluxo HTTP, eles poderão ser interpretados incorretamente na extremidade de recebimento. A codificação de URL substitui caracteres que não são permitidos em uma URL por equivalentes de entidade de caractere que consistem em sequências de escape hexadecimal. Espera-se que a cadeia de caracteres convertida esteja em conformidade com o formato UTF-8.

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

• - (sinal de subtração)

• _ (sublinhado)

• . (ponto final)

• ! (ponto de exclamação)

• * (asterisco)

• ' (aspas simples)

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

Por exemplo, quando inserido em um bloco de texto a ser transmitido em uma URL, os caracteres < e > são codificados como %3c e %3e.

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