Compartilhar via


HttpServerUtility.UrlEncode Método

Definição

Codifica uma cadeia de caracteres para transmissão de HTTP confiável do servidor Web para um cliente através da URL.

Sobrecargas

UrlEncode(String)

Codifica uma cadeia de caracteres em URL e retorna a cadeia de caracteres codificada.

UrlEncode(String, TextWriter)

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

Comentários

UrlEncode é uma maneira conveniente de acessar o HttpUtility.UrlEncode método 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 classe WebUtility.

UrlEncode(String)

Codifica uma cadeia de caracteres em URL e retorna a cadeia de caracteres codificada.

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

s
String

O texto a ser codificado em URL.

Retornos

O texto codificado em URL.

Exemplos

O exemplo a seguir mostra como codificar url de um valor que é 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 é embutido em código neste exemplo apenas para simplificar o exemplo e mostrar o tipo de valor que você pode codificar por URL. Normalmente, você codificaria em URL 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 por URL um valor 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 HttpUtility.UrlEncode método 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 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.

Aplica-se a

UrlEncode(String, TextWriter)

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

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

s
String

A cadeia de texto a ser codificada.

output
TextWriter

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

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 a copia para a cadeia de caracteres 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()
   

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 HttpUtility.UrlEncode método 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 classe WebUtility.

Aplica-se a