HttpServerUtility.UrlEncode Método

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

public string UrlEncode(string s);

member this.UrlEncode : string -> string

Public Function UrlEncode (s As String) As String

Parâmetros

Devoluções

O texto codificado por URL.

Exemplos

O exemplo seguinte mostra como codificar URL um valor usado como valor de string de consulta de um hiperlink. O código reside no ficheiro code-behind de uma página web. O valor a codificar está codificado de forma fixa neste exemplo apenas para simplificar o exemplo e mostrar o tipo de valor que pode codificar por URL. Normalmente, codificaria por URL um valor que recebeu do utilizador ou do pedido. NextPage refere-se a um HyperLink controlo.

public partial class _Default : Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        string destinationURL = "http://www.contoso.com/default.aspx?user=test";

        NextPage.NavigateUrl = "~/Finish?url=" + Server.UrlEncode(destinationURL);
    }             
}

Public Class _Default
    Inherits Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Dim destinationURL = "http://www.contoso.com/default.aspx?user=test"

        NextPage.NavigateUrl = "~/Finish?url=" + Server.UrlEncode(destinationURL)
    End Sub
End Class

O exemplo seguinte é semelhante ao anterior, exceto que mostra como codificar URL um valor dentro de uma classe que não está no ficheiro code-behind.

public class SampleClass
{
    public string GetUrl()
    {
        string destinationURL = "http://www.contoso.com/default.aspx?user=test";

        return "~/Finish?url=" + HttpContext.Current.Server.UrlEncode(destinationURL);
    }
}

Public Class SampleClass
    Public Function GetUrl() As String
        Dim destinationURL = "http://www.contoso.com/default.aspx?user=test"

        Return "~/Finish?url=" + HttpContext.Current.Server.UrlEncode(destinationURL)
    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.UrlEncode em tempo de execução a partir de uma aplicação ASP.NET. Internamente, este método serve HttpUtility.UrlEncode para codificar strings.

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.

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

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

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

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

Parâmetros

Exemplos

O exemplo seguinte codifica uma cadeia para transmissão por HTTP. Codifica a cadeia chamada TestString, que contém o texto "This is a <Test String>.", e copia-a para a cadeia chamada EncodedString "This+is+a+%3cTest+String%3e.".

String TestString = "This is a <Test String>.";
StringWriter writer = new StringWriter();
Server.UrlEncode(TestString, writer);
String EncodedString = writer.ToString();

Dim TestString As String = "This is a <Test String>."
Dim writer As New StringWriter
Server.UrlEncode(TestString, writer)
Dim EncodedString 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.

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

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