HttpEncoder.UrlEncode(Byte[], Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.
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 |