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.Encodes a string for reliable HTTP transmission from the Web server to a client through the URL.

Sobrecargas

UrlEncode(String)

Codifica uma cadeia de caracteres em URL e retorna a cadeia de caracteres codificada.URL-encodes a string and returns the encoded string.

UrlEncode(String, TextWriter)

Codifica uma cadeia de caracteres em URL e envia a saída resultante para um fluxo de saída TextWriter.URL-encodes a string and sends the resulting output to a TextWriter output stream.

Comentários

UrlEncode é uma maneira conveniente de acessar o método HttpUtility.UrlEncode em tempo de execução de um aplicativo ASP.NET.UrlEncode is a convenient way to access the HttpUtility.UrlEncode method at run time from an ASP.NET application. Internamente, UrlEncode usa HttpUtility.UrlEncode para codificar Cadeias de caracteres.Internally, UrlEncode uses HttpUtility.UrlEncode to encode strings.

Para codificar ou decodificar valores fora de um aplicativo Web, use a classe WebUtility.To encode or decode values outside of a web application, use the WebUtility class.

UrlEncode(String)

Codifica uma cadeia de caracteres em URL e retorna a cadeia de caracteres codificada.URL-encodes a string and returns the encoded string.

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.The text to URL-encode.

Retornos

O texto codificado em URL.The URL-encoded text.

Exemplos

O exemplo a seguir mostra como codificar por URL um valor que é usado como um valor de cadeia de caracteres de consulta de um hiperlink.The following example shows how to URL-encode a value that is used as a query string value of a hyperlink. O código reside no arquivo code-behind de uma página da Web.The code resides in the code-behind file for a web page. O valor a ser codificado é embutido no código neste exemplo apenas para simplificar o exemplo e mostrar o tipo de valor que você pode codificar por URL.The value to encode is hard-coded in this example only to simplify the example and show the type of value you might URL-encode. Normalmente, você deve codificar por URL um valor que você recebeu do usuário ou da solicitação.Typically, you would URL-encode a value that you received from the user or the request. NextPage se refere a um controle de HyperLink.NextPage refers to a HyperLink control.

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 ele mostra como codificar por URL um valor de dentro de uma classe que não está no arquivo code-behind.The next example is similar to the previous example except it shows how to URL-encode a value from within a class that is not in the code-behind file.

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 irão transmitir texto corretamente em cadeias de caracteres de URL.URL encoding ensures that all browsers will correctly transmit text in URL strings. Caracteres como um ponto de interrogação (?), e comercial (&), uma barra (/) e espaços podem ser truncados ou corrompidos por alguns navegadores.Characters such as a question mark (?), ampersand (&), slash mark (/), and spaces might be truncated or corrupted by some browsers. Como resultado, esses caracteres devem ser codificados em marcas de <a> ou em cadeias de caracteres de consulta, em que as cadeias podem ser enviadas novamente por um navegador em uma cadeia de caracteres de solicitação.As a result, these characters must be encoded in <a> tags or in query strings where the strings can be re-sent by a browser in a request string.

Esse método é uma maneira conveniente de acessar o método HttpUtility.UrlEncode em tempo de execução de um aplicativo ASP.NET.This method is a convenient way to access the HttpUtility.UrlEncode method at run time from an ASP.NET application. Internamente, esse método usa HttpUtility.UrlEncode para codificar Cadeias de caracteres.Internally, this method uses HttpUtility.UrlEncode to encode strings.

No arquivo code-behind de uma página da Web ASP.NET, acesse uma instância da classe HttpServerUtility por meio da propriedade Server.In the code-behind file for an ASP.NET web page, access an instance of the HttpServerUtility class through the Server property. Em uma classe que não está em um arquivo code-behind, use HttpContext.Current.Server para acessar uma instância da classe HttpServerUtility.In a class that is not in a code-behind file, use HttpContext.Current.Server to access an instance of the HttpServerUtility class.

Fora de um aplicativo Web, use a classe WebUtility para codificar ou decodificar valores.Outside of a web application, use the WebUtility class to encode or decode values.

UrlEncode(String, TextWriter)

Codifica uma cadeia de caracteres em URL e envia a saída resultante para um fluxo de saída TextWriter.URL-encodes a string and sends the resulting output to a TextWriter output stream.

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.The text string to encode.

output
TextWriter

O fluxo de saída TextWriter que contém a cadeia de caracteres codificada.The TextWriter output stream that contains the encoded string.

Exemplos

O exemplo a seguir codifica uma cadeia de caracteres para transmissão por HTTP.The following example encodes a string for transmission by HTTP. Ele codifica a cadeia de caracteres denominada TestString, que contém o texto "esta é uma cadeia de caracteres de teste <>." e a copia para a cadeia de caracteres chamada EncodedString como "This + is + a +% 3cTest + String% 3E.".It encodes the string named TestString, which contains the text "This is a <Test String>.", and copies it into the string named EncodedString as "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 irão transmitir texto corretamente em cadeias de caracteres de URL.URL encoding ensures that all browsers will correctly transmit text in URL strings. Caracteres como um ponto de interrogação (?), e comercial (&), uma barra (/) e espaços podem ser truncados ou corrompidos por alguns navegadores.Characters such as a question mark (?), ampersand (&), slash mark (/), and spaces might be truncated or corrupted by some browsers. Como resultado, esses caracteres devem ser codificados em marcas de <a> ou em cadeias de caracteres de consulta, em que as cadeias podem ser enviadas novamente por um navegador em uma cadeia de caracteres de solicitação.As a result, these characters must be encoded in <a> tags or in query strings where the strings can be re-sent by a browser in a request string.

UrlEncode é uma maneira conveniente de acessar o método HttpUtility.UrlEncode em tempo de execução de um aplicativo ASP.NET.UrlEncode is a convenient way to access the HttpUtility.UrlEncode method at run time from an ASP.NET application. Internamente, UrlEncode usa HttpUtility.UrlEncode para codificar Cadeias de caracteres.Internally, UrlEncode uses HttpUtility.UrlEncode to encode strings.

Para codificar ou decodificar valores fora de um aplicativo Web, use a classe WebUtility.To encode or decode values outside of a web application, use the WebUtility class.

Aplica-se a