HttpUtility.UrlEncode Método

Definição

Namespace:

System.Web

Assembly:

System.Web.HttpUtility.dll

Codifica uma cadeia de caracteres de URL. Essas sobrecargas de método podem ser usadas para codificar a URL inteira, incluindo valores de cadeia de caracteres de consulta.

Para codificar ou decodificar valores fora de um aplicativo Web, use a classe WebUtility.

Sobrecargas

UrlEncode(Byte[], Int32, Int32)	Converte uma matriz de bytes em uma cadeia de caracteres codificada de 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 URL codificada.
UrlEncode(String)	Codifica uma cadeia de caracteres de URL.

UrlEncode(Byte[], Int32, Int32)

Origem:

HttpUtility.cs

Converte uma matriz de bytes em uma cadeia de caracteres codificada de 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 ser codificada.

offset

Int32

A posição na matriz de bytes na qual começar a codificação.

count

Int32

O número de bytes a ser codificado.

Retornos

String

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 interpretados incorretamente na extremidade de 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 ser transmitido em uma URL, eles são codificados como %3c e %3e.

Para codificar ou decodificar valores fora de um aplicativo Web, use a classe WebUtility.

Confira também

• UrlDecode(String)
• Como proteger contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres

UrlEncode(String, Encoding)

Origem:

HttpUtility.cs

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.

e

Encoding

O objeto Encoding que especifica o esquema de codificação.

Retornos

String

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 interpretados incorretamente na extremidade de 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 ser transmitido em uma URL, eles são codificados como %3c e %3e.

Para codificar ou decodificar valores fora de um aplicativo Web, use a classe WebUtility.

Confira também

• UrlDecode(String)
• Como proteger contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres

UrlEncode(Byte[])

Origem:

HttpUtility.cs

Converte uma matriz de bytes em uma cadeia de caracteres 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 ser codificada.

Retornos

String

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 interpretados incorretamente na extremidade de 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 ser transmitido em uma URL, eles são codificados como %3c e %3e.

Para codificar ou decodificar valores fora de um aplicativo Web, use a classe WebUtility.

Confira também

• UrlDecode(String)
• Como proteger contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres

UrlEncode(String)

Origem:

HttpUtility.cs

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

String

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 na extremidade de 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 ser transmitido em uma URL, eles são codificados como %3c e %3e.

Você pode codificar uma URL usando com 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 do caminho de uma URL para garantir uma URL decodificada consistente, independentemente de qual plataforma ou navegador executa 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 UrlEncode método 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 classe WebUtility.

Confira também

• UrlDecode(String)
• Como proteger contra explorações de script em um aplicativo Web aplicando codificação HTML a cadeias de caracteres