HttpEncoder.UrlEncode(Byte[], Int32, Int32) Método

Definição

Namespace:

System.Web.Util

Assemblies:

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

Assembly:

System.Web.Services.dll

Codifica uma matriz de caracteres que não são permitidos em uma URL em uma entidade de caracteres hexadecimais equivalente.

protected public:
 virtual cli::array <System::Byte> ^ UrlEncode(cli::array <System::Byte> ^ bytes, int offset, int count);

protected internal virtual byte[] UrlEncode (byte[] bytes, int offset, int count);

abstract member UrlEncode : byte[] * int * int -> byte[]
override this.UrlEncode : byte[] * int * int -> byte[]

Protected Friend Overridable Function UrlEncode (bytes As Byte(), offset As Integer, count As Integer) As Byte()

Parâmetros

bytes

Byte[]

Uma matriz de bytes a ser codificada.

offset

Int32

A posição na matriz bytes na qual a codificação será iniciada.

count

Int32

O número de itens na matriz bytes a serem codificados.

Retornos

Byte[]

Uma matriz de caracteres codificados.

Exceções

ArgumentOutOfRangeException

offset é menor que zero ou maior que o tamanho da matriz bytes.

- ou - count é menor que zero ou a soma de count e offset é maior que o tamanho da matriz bytes.

ArgumentNullException

bytes é null.

Comentários

O UrlEncode método é chamado por vários métodos de codificação de URL na HttpUtility classe.

O UrlEncode método URL-codifica qualquer caractere que não esteja no conjunto de caracteres ASCII considerado como URL-safe. Os espaços são codificados como o +" caractere ASCII ". Os caracteres ASCII seguros para URL incluem os caracteres ASCII (a a Z e a a z), numerais (0 a 9) e algumas marcas de pontuação. A tabela a seguir lista os sinais de pontuação que são considerados caracteres ASCII seguros para URL.

Caractere	Descrição
-	Hífen
_	Sublinhado
.	Período (ponto)
!	Ponto de exclamação
*	Asterisco (estrela)
(	Parêntese de abertura
)	Parêntese de fechamento