HttpServerUtility.UrlEncode HttpServerUtility.UrlEncode HttpServerUtility.UrlEncode HttpServerUtility.UrlEncode Method

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) UrlEncode(String) UrlEncode(String) 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) UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) 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 para acessar o HttpUtility.UrlEncode método 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) UrlEncode(String) UrlEncode(String) 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 String String String

O texto a ser codificado em URL.The text to URL-encode.

Retornos

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

Exemplos

A exemplo a seguir mostra como codificar na URL de 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 de code-behind para uma página da web.The code resides in the code-behind file for a web page. 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 a 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ê faria codificar a URL de um valor que você recebeu do usuário ou a solicitação.Typically, you would URL-encode a value that you received from the user or the request. NextPage refere-se a um HyperLink controle.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 para codificar a URL de 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

Codificação de URL, você garante que todos os navegadores transmitirá corretamente o texto em cadeias de caracteres de URL.URL encoding ensures that all browsers will correctly transmit text in URL strings. Caracteres como uma pergunta marcam (?), e comercial (&), barra (/) de marcar 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 <a> marcas ou na consulta cadeias de caracteres onde as cadeias de caracteres 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 HttpUtility.UrlEncode método 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.

O arquivo code-behind para uma página da web, acessar uma instância das HttpServerUtility classe por meio o Server propriedade.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 HttpServerUtility classe.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 o WebUtility classe para codificar ou decodificar valores.Outside of a web application, use the WebUtility class to encode or decode values.

UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) 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 String String String

A cadeia de texto a ser codificada.The text string to encode.

output
TextWriter TextWriter TextWriter 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 "Este é um <cadeia de caracteres de teste >." e a copia na cadeia de caracteres denominada EncodedString como "Este + é + a + % 3cTest + cadeia de caracteres % 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

Codificação de URL, você garante que todos os navegadores transmitirá corretamente o texto em cadeias de caracteres de URL.URL encoding ensures that all browsers will correctly transmit text in URL strings. Caracteres como uma pergunta marcam (?), e comercial (&), barra (/) de marcar 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 <a> marcas ou na consulta cadeias de caracteres onde as cadeias de caracteres 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 para acessar o HttpUtility.UrlEncode método 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