Compartilhar via


HttpUtility.UrlEncode Método

Definição

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
Origem:
HttpUtility.cs
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);
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

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

Aplica-se a

UrlEncode(String, Encoding)

Origem:
HttpUtility.cs
Origem:
HttpUtility.cs
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);
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

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

Aplica-se a

UrlEncode(Byte[])

Origem:
HttpUtility.cs
Origem:
HttpUtility.cs
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);
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

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

Aplica-se a

UrlEncode(String)

Origem:
HttpUtility.cs
Origem:
HttpUtility.cs
Origem:
HttpUtility.cs

Codifica uma cadeia de caracteres de URL.

public:
 static System::String ^ UrlEncode(System::String ^ str);
public static string? UrlEncode (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 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

Aplica-se a