Compartilhar via

HttpServerUtility.UrlEncode Método

  • Referência

Definição

Namespace:
System.Web
Assembly:
System.Web.dll

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

String

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