HttpServerUtility.HtmlDecode Método

Definição

Espaço de Nomes:
System.Web
Assemblagem:
System.Web.dll

Decodifica uma cadeia que foi codificada para eliminar caracteres HTML inválidos.

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

Sobrecargas

Name Description
HtmlDecode(String)

Descodifica uma cadeia codificada em HTML e devolve a cadeia decodificada.
HtmlDecode(String, TextWriter)

Descodifica uma cadeia codificada em HTML e envia a saída resultante para um TextWriter fluxo de saída.

HtmlDecode(String)

Descodifica uma cadeia codificada em HTML e devolve a cadeia decodificada.

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

Parâmetros

s
String

A string HTML para descodificar.

Devoluções

String

O texto decifrado.

Exemplos

O exemplo seguinte contém a função LoadDecodedFile, que decodifica os dados de um ficheiro e os copia numa única cadeia.

<%@ PAGE LANGUAGE = "C#" %>
 <%@ IMPORT NAMESPACE = "System.IO" %>
 
 <html xmlns="http://www.w3.org/1999/xhtml">
 <script runat ="server">
 
    String LoadDecodedFile(String file)
       {
       String DecodedString = "";
       FileStream fs = new FileStream(file, FileMode.Open);
       StreamReader r = new StreamReader(fs);
 
       // Position the file pointer at the beginning of the file.
       r.BaseStream.Seek(0, SeekOrigin.Begin);
       
       // Read the entire file into a string and decode each chunk.  
       while (r.Peek() > -1)
          DecodedString += Server.HtmlDecode(r.ReadLine());
 
       r.Close();
       return DecodedString; 
       }
 
 </script>
 <head runat="server">
 <title>HttpServerUtility.HtmlDecode Example</title>
 </head>
 <body></body>
 </html>


<%@ PAGE LANGUAGE = "VB" %>
<%@ Import Namespace="System.IO" %>
 
<html xmlns="http://www.w3.org/1999/xhtml">
<script runat = "server">
 
   Function LoadDecodedFile(file As String) As String
      Dim DecodedString As String
      Dim fs As New FileStream(file, FileMode.Open)
      Dim r As New StreamReader(fs)
      ' Position the file pointer at the beginning of the file.
      r.BaseStream.Seek(0, SeekOrigin.Begin)
      ' Read the entire file into a string and decode each chunk.
      Do While r.Peek() > -1
         DecodedString = DecodedString & _
            Server.HtmlDecode(r.ReadLine())
      Loop
      r.Close()
      LoadDecodedFile = DecodedString
   End Function
 
</script>
<head runat="server">
    <title> HttpServerUtility.HtmlDecode Example</title>
</head>
<body></body>
</html>

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 &lt; e &gt;, o que faz com que o navegador mostre corretamente o sign menor que e o sinal maior que o signo. HtmlDecode decodifica o texto que foi transmitido para o servidor.

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

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.

Aplica-se a

HtmlDecode(String, TextWriter)

Descodifica uma cadeia codificada em HTML e envia a saída resultante para um TextWriter fluxo de saída.

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

Parâmetros

s
String

A string HTML para descodificar.

output
TextWriter

O TextWriter fluxo de saída que contém a cadeia decodificada.

Exemplos

O exemplo seguinte decodifica uma cadeia que foi codificada em HTML para transmissão via HTTP. Decodifica a cadeia fornecida nomeada EncodedString que contém o texto "This is a <Test String>.", e copia-a para a string chamada DecodedString "This is a <Test String>.".

String EncodedString = "This is a &ltTest String&gt.";
StringWriter writer = new StringWriter();
Server.HtmlDecode(EncodedString, writer);
String DecodedString = writer.ToString();


Dim EncodedString As String = "This is a &ltTest String&gt."
Dim writer As New StringWriter
Server.HtmlDecode(EncodedString, writer)
Dim DecodedString As String = writer.ToString()

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 &lt; e &gt;, o que faz com que o navegador mostre corretamente o sign menor que e o sinal maior que o signo.

HtmlDecode decodifica o texto que foi transmitido para o servidor.

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

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

Aplica-se a