HttpServerUtility.HtmlEncode Método

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

Devoluções

O texto codificado em HTML.

Exemplos

O exemplo seguinte mostra como codificar em HTML um valor que potencialmente codifica código inseguro. O código reside no ficheiro code-behind de uma página web. O valor a codificar está codificado diretamente neste exemplo apenas para simplificar o exemplo e mostrar o tipo de valor que pode codificar em HTML. Normalmente, codificaria em HTML um valor que recebeu do utilizador ou do pedido. Result refere-se a um Literal controlo.

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

O exemplo seguinte é semelhante ao anterior, exceto que mostra como codificar em HTML um valor dentro de uma classe que não está no ficheiro code-behind.

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

Observações

A codificação HTML garante que o texto é exibido corretamente no navegador e não interpretado pelo navegador como HTML. Por exemplo, se uma cadeia de texto contiver um signo menor que (<) ou maior que um signo (>), o navegador interpretaria esses caracteres como o colchete de abertura ou encerramento de uma etiqueta HTML. Quando os caracteres são codificados em HTML, são convertidos para as strings < e >, o que faz com que o navegador mostre corretamente o sign menor que e o sinal maior que o signo.

Este método é uma forma conveniente de aceder ao método HttpUtility.HtmlEncode em tempo de execução a partir de uma aplicação ASP.NET. Internamente, este método serve HttpUtility.HtmlEncode para codificar strings.

No ficheiro code-behind de uma página web ASP.NET, acede a uma instância da classe HttpServerUtility através da propriedade Server. Numa classe que não está num ficheiro code-behind, use HttpContext.Current.Server para aceder a uma instância da HttpServerUtility classe.

Fora de uma aplicação web, use a WebUtility classe para codificar ou decodificar valores.

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

Exemplos

O exemplo seguinte codifica uma cadeia para transmissão por HTTP. Codifica a cadeia chamada TestString, que contém o texto "This is a <Test String>.", e copia-a para a string chamada EncodedString "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()
   

Observações

A codificação HTML garante que o texto será corretamente apresentado no navegador, e não interpretado pelo navegador como HTML. Por exemplo, se uma cadeia de texto contiver um signo menor que (<) ou maior que sinal (>), o navegador interpretaria esses caracteres como um colchete de abertura ou fecho de uma etiqueta HTML. A codificação HTML destes dois caracteres é < e >, respetivamente, o que faz com que o navegador mostre corretamente o sign menor que e o sinal maior que o signo.

HtmlEncode é uma forma conveniente de aceder ao método HttpUtility.HtmlEncode em tempo de execução a partir de uma aplicação ASP.NET. Internamente, HtmlEncode é usado HttpUtility.HtmlEncode para codificar strings.

Para codificar ou decodificar valores fora de uma aplicação web, use a WebUtility classe.