HttpServerUtility.UrlDecode Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Decodifica uma cadeia de caracteres codificada para transmissão HTTP e posteriormente enviada para o servidor em uma URL.

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

Sobrecargas

UrlDecode(String)	Decodifica uma cadeia de caracteres em URL e retorna a cadeia de caracteres decodificada.
UrlDecode(String, TextWriter)	Decodifica uma cadeia de caracteres HTML recebida em uma URL e envia a saída resultante para um fluxo de saída TextWriter.

UrlDecode(String)

Decodifica uma cadeia de caracteres em URL e retorna a cadeia de caracteres decodificada.

public:
 System::String ^ UrlDecode(System::String ^ s);

public string UrlDecode (string s);

member this.UrlDecode : string -> string

Public Function UrlDecode (s As String) As String

Parâmetros

s

String

A cadeia de texto a ser decodificada.

Retornos

String

O texto decodificado.

Exemplos

O exemplo a seguir mostra como decodificar por URL um valor recuperado da cadeia de caracteres de consulta. O código reside no arquivo code-behind de uma página da Web. ReturnPage refere-se a um HyperLink controle .

public partial class _Default : Page
{       
    protected void Page_Load(object sender, EventArgs e)
    {
        string returnUrl = Server.UrlDecode(Request.QueryString["url"]);
        ReturnPage.NavigateUrl = returnUrl;
    }
}

Public Class _Default
    Inherits Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Dim returnUrl = Server.UrlDecode(Request.QueryString("url"))
        ReturnPage.NavigateUrl = returnUrl
    End Sub
End Class

O exemplo a seguir é semelhante ao exemplo anterior, exceto que mostra como decodificar por URL um valor de dentro de uma classe que não está no arquivo code-behind.

public class SampleClass
{
    public string RetrievePassedUrl()
    {
        return HttpContext.Current.Server.UrlDecode(HttpContext.Current.Request.QueryString["url"]);
    }
}

Public Class SampleClass
    Public Function RetrievePassedUrl() As String
        Return HttpContext.Current.Server.UrlDecode(HttpContext.Current.Request.QueryString("url"))
    End Function
End Class

Comentários

A codificação de URL garante que todos os navegadores transmitam texto corretamente em cadeias de caracteres de URL. Caracteres como um ponto de interrogação (?), e comercial (&), barra (/) e espaços podem ser truncados ou corrompidos por alguns navegadores. Como resultado, esses caracteres devem ser codificados em <a> marcas ou em cadeias de caracteres de consulta em que as cadeias de caracteres podem ser reenançadas por um navegador em uma cadeia de caracteres de solicitação.

Esse método é uma maneira conveniente de acessar o HttpUtility.UrlDecode método em tempo de execução de um aplicativo ASP.NET. Internamente, esse método usa para decodificar cadeias HttpUtility.UrlDecode de caracteres.

No arquivo code-behind de uma página da Web ASP.NET, acesse uma instância da HttpServerUtility classe por meio da Server propriedade . Em uma classe que não está em um arquivo code-behind, use HttpContext.Current.Server para acessar uma instância da HttpServerUtility classe .

Fora de um aplicativo Web, use a WebUtility classe para codificar ou decodificar valores.

UrlDecode(String, TextWriter)

Decodifica uma cadeia de caracteres HTML recebida em uma URL e envia a saída resultante para um fluxo de saída TextWriter.

public:
 void UrlDecode(System::String ^ s, System::IO::TextWriter ^ output);

public void UrlDecode (string s, System.IO.TextWriter output);

member this.UrlDecode : string * System.IO.TextWriter -> unit

Public Sub UrlDecode (s As String, output As TextWriter)

Parâmetros

s

String

A cadeia de caracteres HTML a ser decodificada.

output

TextWriter

O fluxo de saída TextWriter que contém a cadeia de caracteres codificada.

Exemplos

O exemplo a seguir decodifica a cadeia de caracteres chamada EncodedString (recebida em uma URL) na cadeia de caracteres chamada DecodedString.

StringWriter writer = new StringWriter();
Server.UrlDecode(EncodedString, writer);
String DecodedString = writer.ToString();

Dim writer As New StringWriter
Server.UrlDecode(EncodedString, writer)
Dim DecodedString As String = writer.ToString()
   

Comentários

A codificação de URL garante que todos os navegadores transmitam texto corretamente em cadeias de caracteres de URL. Caracteres como um ponto de interrogação (?), e comercial (&), barra (/) e espaços podem ser truncados ou corrompidos por alguns navegadores. Como resultado, esses caracteres devem ser codificados em <a> marcas ou em cadeias de caracteres de consulta em que as cadeias de caracteres podem ser reenançadas por um navegador em uma cadeia de caracteres de solicitação.

UrlDecode é uma maneira conveniente de acessar o HttpUtility.UrlDecode método em tempo de execução de um aplicativo ASP.NET. Internamente, UrlDecode usa HttpUtility.UrlDecode para decodificar cadeias de caracteres.

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