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

Retornos

O texto codificado em URL.

Exemplos

O exemplo a seguir mostra como codificar uma URL de um valor usado como um valor de cadeia de caracteres de consulta de um hiperlink. O código reside no arquivo code-behind de uma página da Web. O valor a ser codificado é codificado neste exemplo apenas para simplificar o exemplo e mostrar o tipo de valor que você pode codificar url. Normalmente, você codificaria uma URL de um valor que recebeu do usuário ou da solicitação. NextPage refere-se a um HyperLink controle.

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 a seguir é semelhante ao exemplo anterior, exceto que mostra como codificar um valor de URL de dentro de uma classe que não está no arquivo 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

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 método HttpUtility.UrlEncode em tempo de execução de um aplicativo ASP.NET. Internamente, esse método usa para codificar cadeias HttpUtility.UrlEncode de caracteres.

No arquivo code-behind de uma página da Web ASP.NET, acesse uma instância da classe HttpServerUtility por meio da propriedade Server. 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.

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 a seguir codifica uma cadeia de caracteres para transmissão por HTTP. Ele codifica a cadeia de caracteres chamada TestString, que contém o texto "This is a <Test String>.", e copia-a para a cadeia de caracteres denominada 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()
   

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.

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

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