HttpServerUtility.UrlDecode Método

Definição

Decodifica uma cadeia que foi codificada para transmissão HTTP e depois enviada ao servidor numa URL.

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

Sobrecargas

Name Description
UrlDecode(String)

URL decodifica uma cadeia e devolve a cadeia decodificada.

UrlDecode(String, TextWriter)

Descodifica uma string HTML recebida numa URL e envia a saída resultante para um TextWriter fluxo de saída.

UrlDecode(String)

URL decodifica uma cadeia e devolve a cadeia 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 decodificar.

Devoluções

O texto decifrado.

Exemplos

O exemplo seguinte mostra como decodificar por URL um valor que é recuperado da cadeia de consulta. O código reside no ficheiro code-behind de uma página web. ReturnPage refere-se a um HyperLink controlo.

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 seguinte é semelhante ao anterior, exceto que mostra como decodificar por URL um valor dentro de uma classe que não está no ficheiro 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

Observações

A codificação de URL garante que todos os navegadores transmitam corretamente texto em cadeias de URL. Caracteres como um ponto de interrogação (?), e ampersand (&), barra (/) e espaços podem ser truncados ou corrompidos por alguns navegadores. Como resultado, estes caracteres devem ser codificados em <a> etiquetas ou em strings de consulta, onde as strings podem ser reenviadas por um navegador numa string de pedido.

Este método é uma forma conveniente de aceder ao método HttpUtility.UrlDecode em tempo de execução a partir de uma aplicação ASP.NET. Internamente, este método serve HttpUtility.UrlDecode para decodificar cadeias de caracteres.

No ficheiro code-behind de uma página web ASP.NET, acede a uma instância da classe HttpServerUtility através da propriedade Server. Numa classe que não está num ficheiro code-behind, use HttpContext.Current.Server para aceder a uma instância da HttpServerUtility classe.

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

Aplica-se a

UrlDecode(String, TextWriter)

Descodifica uma string HTML recebida numa URL e envia a saída resultante para um TextWriter fluxo de saída.

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 string HTML para descodificar.

output
TextWriter

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

Exemplos

O exemplo seguinte decodifica a cadeia nomeada EncodedString (recebida numa URL) na cadeia 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()
   

Observações

A codificação de URL garante que todos os navegadores transmitam corretamente texto em cadeias de URL. Caracteres como um ponto de interrogação (?), e ampersand (&), barra (/) e espaços podem ser truncados ou corrompidos por alguns navegadores. Como resultado, estes caracteres devem ser codificados em <a> etiquetas ou em strings de consulta, onde as strings podem ser reenviadas por um navegador numa string de pedido.

UrlDecode é uma forma conveniente de aceder ao método HttpUtility.UrlDecode em tempo de execução a partir de uma aplicação ASP.NET. Internamente, UrlDecode usa HttpUtility.UrlDecode para decodificar strings.

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

Aplica-se a