HttpUtility.UrlEncode 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 cadeia de caracteres de URL. Essas sobrecargas de método podem ser usadas para codificar toda a URL, incluindo valores de cadeia de caracteres de consulta.
Para codificar ou decodificar valores fora de um aplicativo Web, use a WebUtility classe.
Sobrecargas
| Nome | Description |
|---|---|
| UrlEncode(Byte[], Int32, Int32) |
Converte uma matriz de bytes em uma cadeia de caracteres codificada em URL, começando na posição especificada na matriz e continuando para o número especificado de bytes. |
| UrlEncode(String, Encoding) |
Codifica uma cadeia de caracteres de URL usando o objeto de codificação especificado. |
| UrlEncode(Byte[]) |
Converte uma matriz de bytes em uma cadeia de caracteres de URL codificada. |
| UrlEncode(String) |
Codifica uma cadeia de caracteres de URL. |
UrlEncode(Byte[], Int32, Int32)
Converte uma matriz de bytes em uma cadeia de caracteres codificada em URL, começando na posição especificada na matriz e continuando para o número especificado de bytes.
public:
static System::String ^ UrlEncode(cli::array <System::Byte> ^ bytes, int offset, int count);
public static string UrlEncode(byte[] bytes, int offset, int count);
static member UrlEncode : byte[] * int * int -> string
Public Shared Function UrlEncode (bytes As Byte(), offset As Integer, count As Integer) As String
Parâmetros
- bytes
- Byte[]
A matriz de bytes a serem codificados.
- offset
- Int32
A posição na matriz de bytes na qual iniciar a codificação.
- count
- Int32
O número de bytes a serem codificados.
Retornos
Uma cadeia de caracteres codificada.
Comentários
O UrlEncode(String) método pode ser usado para codificar toda a URL, incluindo valores de cadeia de caracteres de consulta. Se caracteres como espaços em branco e pontuação forem passados em um fluxo HTTP, eles poderão ser mal interpretados no final do recebimento. A codificação de URL converte caracteres que não são permitidos em uma URL em equivalentes de entidade de caractere; A decodificação de URL inverte a codificação. Por exemplo, quando os caracteres < e > são inseridos em um bloco de texto a serem transmitidos em uma URL, eles são codificados como %3c e %3e.
Para codificar ou decodificar valores fora de um aplicativo Web, use a WebUtility classe.
Confira também
- UrlDecode(String)
- Como proteger contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres
Aplica-se a
UrlEncode(String, Encoding)
Codifica uma cadeia de caracteres de URL usando o objeto de codificação especificado.
public:
static System::String ^ UrlEncode(System::String ^ str, System::Text::Encoding ^ e);
public static string UrlEncode(string str, System.Text.Encoding e);
static member UrlEncode : string * System.Text.Encoding -> string
Public Shared Function UrlEncode (str As String, e As Encoding) As String
Parâmetros
- str
- String
O texto a ser codificado.
Retornos
Uma cadeia de caracteres codificada.
Comentários
Esse método pode ser usado para codificar toda a URL, incluindo valores de cadeia de caracteres de consulta. Se caracteres como espaços em branco e pontuação forem passados em um fluxo HTTP, eles poderão ser mal interpretados no final do recebimento. A codificação de URL converte caracteres que não são permitidos em uma URL em equivalentes de entidade de caractere; A decodificação de URL inverte a codificação. Por exemplo, quando os caracteres < e > são inseridos em um bloco de texto a serem transmitidos em uma URL, eles são codificados como %3c e %3e.
Para codificar ou decodificar valores fora de um aplicativo Web, use a WebUtility classe.
Confira também
- UrlDecode(String)
- Como proteger contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres
Aplica-se a
UrlEncode(Byte[])
Converte uma matriz de bytes em uma cadeia de caracteres de URL codificada.
public:
static System::String ^ UrlEncode(cli::array <System::Byte> ^ bytes);
public static string UrlEncode(byte[] bytes);
static member UrlEncode : byte[] -> string
Public Shared Function UrlEncode (bytes As Byte()) As String
Parâmetros
- bytes
- Byte[]
A matriz de bytes a serem codificados.
Retornos
Uma cadeia de caracteres codificada.
Comentários
O UrlEncode método pode ser usado para codificar toda a URL, incluindo valores de cadeia de caracteres de consulta. Se caracteres como espaços em branco e pontuação forem passados em um fluxo HTTP, eles poderão ser mal interpretados no final do recebimento. A codificação de URL converte caracteres que não são permitidos em uma URL em equivalentes de entidade de caractere; A decodificação de URL inverte a codificação. Por exemplo, quando os caracteres < e > são inseridos em um bloco de texto a serem transmitidos em uma URL, eles são codificados como %3c e %3e.
Para codificar ou decodificar valores fora de um aplicativo Web, use a WebUtility classe.
Confira também
- UrlDecode(String)
- Como proteger contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres
Aplica-se a
UrlEncode(String)
Codifica uma cadeia de caracteres de URL.
public:
static System::String ^ UrlEncode(System::String ^ str);
public static string UrlEncode(string str);
static member UrlEncode : string -> string
Public Shared Function UrlEncode (str As String) As String
Parâmetros
- str
- String
O texto a ser codificado.
Retornos
Uma cadeia de caracteres codificada.
Comentários
O UrlEncode(String) método pode ser usado para codificar toda a URL, incluindo valores de cadeia de caracteres de consulta. Se caracteres como espaços em branco e pontuação forem passados em um fluxo HTTP sem codificação, eles poderão ser interpretados incorretamente no final do recebimento. A codificação de URL converte caracteres que não são permitidos em uma URL em equivalentes de entidade de caractere; A decodificação de URL inverte a codificação. Por exemplo, quando os caracteres < e > são inseridos em um bloco de texto a serem transmitidos em uma URL, eles são codificados como %3c e %3e.
Você pode codificar uma URL usando o UrlEncode método ou o UrlPathEncode método. No entanto, os métodos retornam resultados diferentes. O UrlEncode método converte cada caractere de espaço em um caractere de adição (+). O UrlPathEncode método converte cada caractere de espaço na cadeia de caracteres "%20", que representa um espaço na notação hexadecimal. Use o UrlPathEncode método ao codificar a parte de caminho de uma URL para garantir uma URL decodificada consistente, independentemente de qual plataforma ou navegador execute a decodificação.
O HttpUtility.UrlEncode método usa a codificação UTF-8 por padrão. Portanto, o uso do UrlEncode método fornece os mesmos resultados que usar o UrlEncode método e especificar UTF8 como o segundo parâmetro.
UrlEncode é uma maneira conveniente de acessar o método UrlEncode em tempo de execução de um aplicativo ASP.NET. Internamente, UrlEncode usa o UrlEncode método para codificar cadeias de caracteres.
Para codificar ou decodificar valores fora de um aplicativo Web, use a WebUtility classe.
Confira também
- UrlDecode(String)
- Como proteger contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres