HttpUtility.UrlEncode Método

Definição

Espaço de Nomes:
System.Web
Assemblagem:
System.Web.dll
Assemblagens:
System.Web.dll, System.Web.Services.dll
Assemblagem:
netstandard.dll

Codifica uma cadeia de URL. Estas sobrecargas de métodos podem ser usadas para codificar toda a URL, incluindo valores de sequência de consulta.

Para codificar ou decodificar valores fora de uma aplicação web, use a WebUtility classe.

Sobrecargas

Name Description
UrlEncode(Byte[], Int32, Int32)

Converte um array de bytes numa string codificada por URL, começando na posição especificada no array e continuando pelo número especificado de bytes.
UrlEncode(String, Encoding)

Codifica uma cadeia de URL usando o objeto de codificação especificado.
UrlEncode(Byte[])

Converte um array de bytes numa cadeia de URL codificada.
UrlEncode(String)

Codifica uma cadeia de URL.

UrlEncode(Byte[], Int32, Int32)

Converte um array de bytes numa string codificada por URL, começando na posição especificada no array e continuando pelo 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[]

O array de bytes a codificar.

offset
Int32

A posição no array de bytes onde começar a codificar.

count
Int32

O número de bytes a codificar.

Devoluções

String

Uma cadeia codificada.

Observações

O UrlEncode(String) método pode ser usado para codificar toda a URL, incluindo os valores das strings de consulta. Se caracteres como espaços em branco e pontuação forem passados num fluxo HTTP, podem ser mal interpretados na parte receptora. A codificação de URL converte caracteres que não são permitidos numa URL em equivalentes entidade-carácter; A decodificação por URL inverte a codificação. Por exemplo, quando os caracteres < e > estão embutidos num bloco de texto a ser transmitido numa URL, são codificados como %3c e %3e.

Para codificar ou decodificar valores fora de uma aplicação web, use a WebUtility classe.

Ver também

Aplica-se a

UrlEncode(String, Encoding)

Codifica uma cadeia 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 codificar.

e
Encoding

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

Devoluções

String

Uma cadeia codificada.

Observações

Este método pode ser usado para codificar toda a URL, incluindo os valores das strings de consulta. Se caracteres como espaços em branco e pontuação forem passados num fluxo HTTP, podem ser mal interpretados na parte receptora. A codificação de URL converte caracteres que não são permitidos numa URL em equivalentes entidade-carácter; A decodificação por URL inverte a codificação. Por exemplo, quando os caracteres < e > estão embutidos num bloco de texto a ser transmitido numa URL, são codificados como %3c e %3e.

Para codificar ou decodificar valores fora de uma aplicação web, use a WebUtility classe.

Ver também

Aplica-se a

UrlEncode(Byte[])

Converte um array de bytes numa cadeia 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[]

O array de bytes a codificar.

Devoluções

String

Uma cadeia codificada.

Observações

O UrlEncode método pode ser usado para codificar toda a URL, incluindo os valores das strings de consulta. Se caracteres como espaços em branco e pontuação forem passados num fluxo HTTP, podem ser mal interpretados na parte receptora. A codificação de URL converte caracteres que não são permitidos numa URL em equivalentes entidade-carácter; A decodificação por URL inverte a codificação. Por exemplo, quando os caracteres < e > estão embutidos num bloco de texto a ser transmitido numa URL, são codificados como %3c e %3e.

Para codificar ou decodificar valores fora de uma aplicação web, use a WebUtility classe.

Ver também

Aplica-se a

UrlEncode(String)

Codifica uma cadeia 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 codificar.

Devoluções

String

Uma cadeia codificada.

Observações

O UrlEncode(String) método pode ser usado para codificar toda a URL, incluindo os valores das strings de consulta. Se caracteres como espaços em branco e pontuação forem passados num fluxo HTTP sem codificação, podem ser mal interpretados na parte receptora. A codificação de URL converte caracteres que não são permitidos numa URL em equivalentes entidade-carácter; A decodificação por URL inverte a codificação. Por exemplo, quando os caracteres < e > estão embutidos num bloco de texto a ser transmitido numa URL, são codificados como %3c e %3e.

Pode codificar uma URL usando com o UrlEncode método ou com o UrlPathEncode método. No entanto, os métodos dão resultados diferentes. O UrlEncode método converte cada carácter de espaço num carácter positivo (+). O UrlPathEncode método converte cada carácter de espaço na cadeia "%20", que representa um espaço em notação hexadecimal. Use o UrlPathEncode método quando codificar a parte do caminho de uma URL para garantir uma URL decodificada consistente, independentemente da plataforma ou navegador que realiza a decodificação.

O HttpUtility.UrlEncode método utiliza codificação UTF-8 por defeito. Portanto, usar o UrlEncode método fornece os mesmos resultados que usar o UrlEncode método e especificar UTF8 como segundo parâmetro.

UrlEncode é uma forma conveniente de aceder ao método UrlEncode em tempo de execução a partir de uma aplicação ASP.NET. Internamente, UrlEncode utiliza o UrlEncode método para codificar strings.

Para codificar ou decodificar valores fora de uma aplicação web, use a WebUtility classe.

Ver também

Aplica-se a