HttpServerUtility.UrlEncode Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

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

Sobrecargas

Nombre	Description
UrlEncode(String)	Codifica una cadena y devuelve la cadena codificada.
UrlEncode(String, TextWriter)	Codifica una cadena y envía la salida resultante a un TextWriter flujo de salida.

Comentarios

es una manera cómoda de acceder al método /> UrlEncode usa HttpUtility.UrlEncode para codificar cadenas.

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

UrlEncode(String)

Codifica 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 en codificación URL.

Devoluciones

String

Texto con codificación URL.

Ejemplos

En el ejemplo siguiente se muestra cómo codificar una dirección URL un valor que se usa como un 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. Los caracteres como un signo de interrogación (?), y (&), la barra diagonal (/) y los espacios podrían estar truncados o dañados por algunos exploradores. Como resultado, estos caracteres deben codificarse 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 método HttpUtility.UrlEncode 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 clase /> . En una clase que no está en un archivo de código subyacente, use HttpContext.Current.Server para acceder 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 una cadena y envía la salida resultante a un TextWriter flujo de salida.

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 codifica.

output

TextWriter

Flujo TextWriter de salida 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. Los caracteres como un signo de interrogación (?), y (&), la barra diagonal (/) y los espacios podrían estar truncados o dañados por algunos exploradores. Como resultado, estos caracteres deben codificarse en <a> etiquetas o en cadenas de consulta en las que un explorador puede volver a enviar las cadenas en una cadena de solicitud.

es una manera cómoda de acceder al método /> UrlEncode usa HttpUtility.UrlEncode para codificar cadenas.

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