HttpServerUtility.HtmlEncode HttpServerUtility.HtmlEncode HttpServerUtility.HtmlEncode HttpServerUtility.HtmlEncode Method

Definición

Codifica una cadena que se va a mostrar en un explorador.Encodes a string to be displayed in a browser.

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.

Sobrecargas

HtmlEncode(String) HtmlEncode(String) HtmlEncode(String) HtmlEncode(String)

Codifica una cadena en HTML y devuelve la cadena codificada.HTML-encodes a string and returns the encoded string.

HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter)

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

HtmlEncode(String) HtmlEncode(String) HtmlEncode(String) HtmlEncode(String)

Codifica una cadena en HTML y devuelve la cadena codificada.HTML-encodes a string and returns the encoded string.

public:
 System::String ^ HtmlEncode(System::String ^ s);
public string HtmlEncode (string s);
member this.HtmlEncode : string -> string
Public Function HtmlEncode (s As String) As String

Parámetros

s
String String String String

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

Devoluciones

Texto codificado en HTML.The HTML-encoded text.

Ejemplos

En el ejemplo siguiente se muestra cómo codificar en HTML un valor que podría codificar código no seguro.The following example shows how to HTML-encode a value that potentially codes unsafe code. 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 en HTML.The value to encode is hard-coded in this example only to simplify the example and show the type of value you might HTML-encode. Normalmente, debe codificar en HTML un valor que haya recibido del usuario o de la solicitud.Typically, you would HTML-encode a value that you received from the user or the request. Resulthace referencia a Literal un control.Result refers to a Literal control.

public partial class _Default : Page
{        
    protected void Page_Load(object sender, EventArgs e)
    {
        Result.Text = Server.HtmlEncode("<script>unsafe</script>");      
    } 
}
Public Class _Default
    Inherits Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Result.Text = Server.HtmlEncode("<script>unsafe</script>")
    End Sub
End Class

El ejemplo siguiente es similar al anterior, salvo que se muestra cómo codificar en HTML 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 HTML-encode a value from within a class that is not in the code-behind file.

public class SampleClass
{
    public string GetEncodedText()
    {
        return HttpContext.Current.Server.HtmlEncode("<script>unsafe</script>");
    }
}
Public Class SampleClass
    Public Function GetEncodedText() As String
        Return HttpContext.Current.Server.HtmlEncode("<script>unsafe</script>")
    End Function
End Class

Comentarios

La codificación HTML garantiza que el texto se muestre correctamente en el explorador y que el explorador no lo interprete como HTML.HTML encoding makes sure that text is displayed correctly in the browser and not interpreted by the browser as HTML. Por ejemplo, si una cadena de texto contiene un signo menor que<() o mayor que (>), el explorador interpretaría estos caracteres como el corchete de apertura o cierre de una etiqueta HTML.For example, if a text string contains a less than sign (<) or greater than sign (>), the browser would interpret these characters as the opening or closing bracket of an HTML tag. Cuando los caracteres están codificados en HTML, se convierten en cadenas &lt; y &gt;, lo que hace que el explorador muestre el signo menor que y mayor que el signo correcto.When the characters are HTML encoded, they are converted to the strings &lt; and &gt;, which causes the browser to display the less than sign and greater than sign correctly.

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

HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter)

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

public:
 void HtmlEncode(System::String ^ s, System::IO::TextWriter ^ output);
public void HtmlEncode (string s, System.IO.TextWriter output);
member this.HtmlEncode : string * System.IO.TextWriter -> unit
Public Sub HtmlEncode (s As String, output As TextWriter)

Parámetros

s
String String String String

Cadena que se va a codificar.The 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 TestStringcadena denominada, que contiene el texto "This is a <Test String >." y la copia en la cadena denominada EncodedString "This is a <Test String>".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 <Test String>.".

String TestString = "This is a <Test String>.";
StringWriter writer = new StringWriter();
Server.HtmlEncode(TestString, writer);
String EncodedString = writer.ToString();
   
Dim TestString As String = "This is a <Test String>."
Dim writer As New StringWriter
Server.HtmlEncode(TestString, writer)
Dim EncodedString As String = writer.ToString()
   

Comentarios

La codificación HTML garantiza que el texto se mostrará correctamente en el explorador, no interpretado por el explorador como HTML.HTML encoding ensures that text will be correctly displayed in the browser, not interpreted by the browser as HTML. Por ejemplo, si una cadena de texto contiene un signo menor que<() o mayor que (>), el explorador interpretaría estos caracteres como un corchete de apertura o cierre de una etiqueta HTML.For example, if a text string contains a less than sign (<) or greater than sign (>), the browser would interpret these characters as an opening or closing bracket of an HTML tag. La codificación HTML de estos dos caracteres es &lt; y &gt;, respectivamente, que hace que el explorador muestre el signo menor que y mayor que el signo correcto.The HTML encoding of these two characters is &lt; and &gt;, respectively, which causes the browser to display the less than sign and greater than sign correctly.

HtmlEncodees una manera cómoda de tener acceso HttpUtility.HtmlEncode al método en tiempo de ejecución desde una aplicación ASP.net.HtmlEncode is a convenient way to access the HttpUtility.HtmlEncode method at run time from an ASP.NET application. Internamente, HtmlEncode utiliza HttpUtility.HtmlEncode para codificar cadenas.Internally, HtmlEncode uses HttpUtility.HtmlEncode 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