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

Definición

Codifica una cadena para una transmisión HTTP segura desde el servidor Web hasta el cliente a través de la dirección 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 mediante URL una cadena y devuelve la cadena codificada.URL-encodes a string and returns the encoded string.

UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) UrlEncode(String, TextWriter)

Codifica mediante URL una cadena y envía el resultado a un flujo de salida de TextWriter.URL-encodes a string and sends the resulting output to a TextWriter output stream.

Comentarios

UrlEncodees una manera cómoda de tener acceso HttpUtility.UrlEncode al método en tiempo de ejecución desde una aplicación ASP.net.UrlEncode is a convenient way to access the HttpUtility.UrlEncode method at run time from an ASP.NET application. Internamente, UrlEncode utiliza HttpUtility.UrlEncode para codificar cadenas.Internally, UrlEncode uses HttpUtility.UrlEncode to encode strings.

Para codificar o descodificar valores fuera de una aplicación web, use la clase WebUtility.To encode or decode values outside of a web application, use the WebUtility class.

UrlEncode(String) UrlEncode(String) UrlEncode(String) UrlEncode(String)

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

Texto que se va a codificar con una dirección URL.The text to URL-encode.

Devoluciones

Texto con código URL.The URL-encoded text.

Ejemplos

En el ejemplo siguiente se muestra cómo codificar en URL un valor que se utiliza como valor de cadena de consulta de un hipervínculo.The following example shows how to URL-encode a value that is used as a query string value of a hyperlink. El código reside en el archivo de código subyacente de una página web.The code resides in the code-behind file for a web page. El valor que se va a codificar está codificado de forma rígida en este ejemplo para simplificar el ejemplo y mostrar el tipo de valor que se puede codificar con 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, debe codificar mediante URL un valor que haya recibido del usuario o de la solicitud.Typically, you would URL-encode a value that you received from the user or the request. NextPagehace referencia a HyperLink un control.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

El ejemplo siguiente es similar al ejemplo anterior, salvo que muestra cómo codificar mediante URL un valor desde una clase que no está en el archivo de código subyacente.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

Comentarios

La codificación de direcciones URL garantiza que todos los exploradores transmitirán correctamente el texto en las cadenas de dirección URL.URL encoding ensures that all browsers will correctly transmit text in URL strings. Algunos exploradores pueden truncar o dañar caracteres como un signo de interrogación (?), una y comercial (&), una marca de barra diagonal (/) y espacios.Characters such as a question mark (?), ampersand (&), slash mark (/), and spaces might be truncated or corrupted by some browsers. Como resultado, estos caracteres se deben codificar en <a> etiquetas o en cadenas de consulta, donde un explorador puede volver a enviar las cadenas en una cadena de solicitud.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.

Este método es una manera cómoda de tener acceso HttpUtility.UrlEncode al método en tiempo de ejecución desde una aplicación ASP.net.This method is a convenient way to access the HttpUtility.UrlEncode method at run time from an ASP.NET application. Internamente, este método usa HttpUtility.UrlEncode para codificar cadenas.Internally, this method uses HttpUtility.UrlEncode to encode strings.

En el archivo de código subyacente de una página web de ASP.net, tiene acceso a una HttpServerUtility instancia de la Server clase a través de la propiedad.In the code-behind file for an ASP.NET web page, access an instance of the HttpServerUtility class through the Server property. En una clase que no está en un archivo de código subyacente, use HttpContext.Current.Server para tener acceso a una instancia HttpServerUtility de la clase.In a class that is not in a code-behind file, use HttpContext.Current.Server to access an instance of the HttpServerUtility class.

Fuera de una aplicación Web, utilice la WebUtility clase para codificar o descodificar 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 mediante URL una cadena y envía el resultado a un flujo de salida de 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

Cadena de texto que se va a codificar.The text string to encode.

output
TextWriter TextWriter TextWriter TextWriter

Flujo de salida de TextWriter que contiene la cadena codificada.The TextWriter output stream that contains the encoded string.

Ejemplos

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

Comentarios

La codificación de direcciones URL garantiza que todos los exploradores transmitirán correctamente el texto en las cadenas de dirección URL.URL encoding ensures that all browsers will correctly transmit text in URL strings. Algunos exploradores pueden truncar o dañar caracteres como un signo de interrogación (?), una y comercial (&), una marca de barra diagonal (/) y espacios.Characters such as a question mark (?), ampersand (&), slash mark (/), and spaces might be truncated or corrupted by some browsers. Como resultado, estos caracteres se deben codificar en <a> etiquetas o en cadenas de consulta, donde un explorador puede volver a enviar las cadenas en una cadena de solicitud.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.

UrlEncodees una manera cómoda de tener acceso HttpUtility.UrlEncode al método en tiempo de ejecución desde una aplicación ASP.net.UrlEncode is a convenient way to access the HttpUtility.UrlEncode method at run time from an ASP.NET application. Internamente, UrlEncode utiliza HttpUtility.UrlEncode para codificar cadenas.Internally, UrlEncode uses HttpUtility.UrlEncode to encode strings.

Para codificar o descodificar valores fuera de una aplicación web, use la clase WebUtility.To encode or decode values outside of a web application, use the WebUtility class.

Se aplica a