HttpServerUtility.HtmlEncode Metodo

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

Codifica una stringa da visualizzare in un browser.

Per codificare o decodificare i valori al di fuori di un'applicazione Web, usare la classe WebUtility.

Overload

HtmlEncode(String)	Codifica in HTML una stringa e restituisce la stringa codificata.
HtmlEncode(String, TextWriter)	Codifica in HTML una stringa e invia l'output risultante a un flusso di output di TextWriter.

HtmlEncode(String)

Codifica in HTML una stringa e restituisce la stringa codificata.

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

Parametri

s

String

Stringa di testo da codificare.

Restituisce

String

Testo codificato in HTML.

Esempio

Nell'esempio seguente viene illustrato come codificare html un valore che codifica potenzialmente codice non sicuro. Il codice si trova nel file code-behind per una pagina Web. Il valore da codificare è hardcoded in questo esempio solo per semplificare l'esempio e visualizzare il tipo di valore che è possibile codificare html. In genere, si codifica html un valore ricevuto dall'utente o dalla richiesta. Result fa riferimento a un Literal controllo .

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

L'esempio successivo è simile all'esempio precedente, ad eccezione del fatto che mostra come codificare HTML un valore dall'interno di una classe che non si trova nel file 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

Commenti

La codifica HTML assicura che il testo venga visualizzato correttamente nel browser e non interpretato dal browser come HTML. Ad esempio, se una stringa di testo contiene un segno minore di (<) o maggiore di segno (>), il browser interpreta questi caratteri come parentesi di apertura o chiusura di un tag HTML. Quando i caratteri sono codificati < in FORMATO HTML, vengono convertiti nelle stringhe e >, che fa sì che il browser visualizzi il segno minore di e maggiore del segno correttamente.

Questo metodo è un modo pratico per accedere al HttpUtility.HtmlEncode metodo in fase di esecuzione da un'applicazione ASP.NET. Internamente, questo metodo usa HttpUtility.HtmlEncode per codificare le stringhe.

Nel file code-behind per una pagina Web ASP.NET accedere a un'istanza della HttpServerUtility classe tramite la Server proprietà . In una classe che non si trova in un file code-behind, usare HttpContext.Current.Server per accedere a un'istanza della HttpServerUtility classe .

All'esterno di un'applicazione Web, usare la WebUtility classe per codificare o decodificare i valori.

HtmlEncode(String, TextWriter)

Codifica in HTML una stringa e invia l'output risultante a un flusso di output di TextWriter.

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)

Parametri

s

String

Stringa da codificare.

output

TextWriter

Flusso di output TextWriter contenente la stringa codificata.

Esempio

Nell'esempio seguente viene codificata una stringa per la trasmissione tramite HTTP. Codifica la stringa denominata , che contiene il testo "This is a Test String>"." e la copia nella stringa denominata TestStringEncodedString "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()
   

Commenti

La codifica HTML garantisce che il testo venga visualizzato correttamente nel browser, non interpretato dal browser come HTML. Ad esempio, se una stringa di testo contiene un segno minore di () o maggiore di segno (<>), il browser interpreterebbe questi caratteri come parentesi di apertura o chiusura di un tag HTML. La codifica HTML di questi due caratteri è < e >, rispettivamente, che fa sì che il browser visualizzi il segno minore di e maggiore del segno correttamente.

HtmlEncode è un modo pratico per accedere al HttpUtility.HtmlEncode metodo in fase di esecuzione da un'applicazione ASP.NET. Internamente, HtmlEncode usa HttpUtility.HtmlEncode per codificare le stringhe.

Per codificare o decodificare i valori al di fuori di un'applicazione Web, usare la classe WebUtility.