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 caractere hexadecimal 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 serem codificados.
- offset
- Int32
A posição na bytes matriz na qual iniciar a codificação.
- count
- Int32
O número de itens na matriz a bytes serem codificados.
Retornos
Uma matriz de caracteres codificados.
Exceções
offset é menor que zero ou maior que o comprimento da bytes matriz.
- ou -
count é menor que zero ou count mais offset é maior que o comprimento da bytes matriz.
bytes é null.
Comentários
O UrlEncode método é chamado por vários métodos de codificação de URL na HttpUtility classe.
A UrlEncode URL do método codifica qualquer caractere que não esteja no conjunto de caracteres ASCII considerados seguros para URL. 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 z), numerais (0 a 9) e algumas marcas de pontuação. A tabela a seguir lista as marcas de pontuação que são consideradas caracteres ASCII seguros para URL.
| Character | Description |
|---|---|
| - | Hífen |
| _ | Sublinhado |
| . | Ponto (ponto) |
| ! | Ponto de exclamação |
| * | Asterisco (estrela) |
| ( | Abrir parênteses |
| ) | Parênteses de fechamento |