HttpServerUtility.UrlEncode Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

Codifica una cadena para una transmisión HTTP segura desde el servidor web hasta el cliente a través de la dirección URL.

Sobrecargas

UrlEncode(String)	Codifica mediante URL una cadena y devuelve la cadena codificada.
UrlEncode(String, TextWriter)	Codifica mediante URL una cadena y envía el resultado a un flujo de salida de TextWriter.

Comentarios

UrlEncode es una manera cómoda de acceder al HttpUtility.UrlEncode método en tiempo de ejecución desde una aplicación ASP.NET. Internamente, UrlEncode usa HttpUtility.UrlEncode para codificar cadenas.

Para codificar o descodificar valores fuera de una aplicación web, use la clase WebUtility.

UrlEncode(String)

Codifica mediante URL una cadena y devuelve la cadena 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

Texto que se va a codificar con una dirección URL.

Devoluciones

String

Texto con código URL.

Ejemplos

En el ejemplo siguiente se muestra cómo codificar url un valor que se usa como valor de cadena de consulta de un hipervínculo. El código reside en el archivo de código subyacente de una página web. El valor que se va a codificar de forma rígida en este ejemplo solo para simplificar el ejemplo y mostrar el tipo de valor que podría codificar con dirección URL. Normalmente, codificaría una dirección URL con un valor que recibió del usuario o de la solicitud. NextPage hace referencia a un 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

El ejemplo siguiente es similar al ejemplo anterior, salvo que muestra cómo codificar una dirección URL un valor desde dentro de una clase que no está en el archivo de código subyacente.

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

Comentarios

La codificación de direcciones URL garantiza que todos los exploradores transmitan correctamente texto en cadenas de dirección URL. Algunos exploradores pueden truncar o dañar caracteres como signo de interrogación (?), y (&), la barra diagonal (/) y los espacios pueden truncarse o dañarse en algunos exploradores. Como resultado, estos caracteres se deben codificar en <a> etiquetas o en cadenas de consulta en las que un explorador puede volver a enviar las cadenas en una cadena de solicitud.

Este método es una manera cómoda de acceder al HttpUtility.UrlEncode método en tiempo de ejecución desde una aplicación de ASP.NET. Internamente, este método usa HttpUtility.UrlEncode para codificar cadenas.

En el archivo de código subyacente de una página web de ASP.NET, acceda a una instancia de la HttpServerUtility clase a través de la Server propiedad . En una clase que no está en un archivo de código subyacente, use HttpContext.Current.Server para tener acceso a una instancia de la HttpServerUtility clase .

Fuera de una aplicación web, use la WebUtility clase para codificar o descodificar valores.

UrlEncode(String, TextWriter)

Codifica mediante URL una cadena y envía el resultado a un flujo de salida de 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

Cadena de texto que se va a codificar.

output

TextWriter

Flujo de salida de TextWriter que contiene la cadena codificada.

Ejemplos

En el ejemplo siguiente se codifica una cadena para la transmisión por HTTP. Codifica la cadena denominada TestString, que contiene el texto "This is a <Test String>.", y lo copia en la cadena 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()
   

Comentarios

La codificación de direcciones URL garantiza que todos los exploradores transmitan correctamente texto en cadenas de dirección URL. Algunos exploradores pueden truncar o dañar caracteres como signo de interrogación (?), y (&), la barra diagonal (/) y los espacios pueden truncarse o dañarse en algunos exploradores. Como resultado, estos caracteres se deben codificar en <a> etiquetas o en cadenas de consulta en las que un explorador puede volver a enviar las cadenas en una cadena de solicitud.

UrlEncode es una manera cómoda de acceder al HttpUtility.UrlEncode método en tiempo de ejecución desde una aplicación ASP.NET. Internamente, UrlEncode usa HttpUtility.UrlEncode para codificar cadenas.

Para codificar o descodificar valores fuera de una aplicación web, use la clase WebUtility.