HttpServerUtility.HtmlEncode Methode

Definitie

Naamruimte:

System.Web

Assembly:

System.Web.dll

Codeert een tekenreeks die moet worden weergegeven in een browser.

Als u waarden buiten een webtoepassing wilt coderen of decoderen, gebruikt u de WebUtility klasse.

Overloads

Name	Description
HtmlEncode(String)	HTML-codeert een tekenreeks en retourneert de gecodeerde tekenreeks.
HtmlEncode(String, TextWriter)	HTML-codeert een tekenreeks en verzendt de resulterende uitvoer naar een TextWriter uitvoerstroom.

HtmlEncode(String)

HTML-codeert een tekenreeks en retourneert de gecodeerde tekenreeks.

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

Parameters

s

String

De tekenreeks die moet worden gecodeerd.

Retouren

String

De met HTML gecodeerde tekst.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een waarde codeert die mogelijk onveilige code codeert. De code bevindt zich in het code-behind-bestand voor een webpagina. De waarde die moet worden gecodeerd, is in dit voorbeeld alleen vastgelegd om het voorbeeld te vereenvoudigen en het type waarde weer te geven dat u in HTML-codering kunt gebruiken. Normaal gesproken coderen we een waarde die u hebt ontvangen van de gebruiker of de aanvraag. Result verwijst naar een Literal besturingselement.

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

Het volgende voorbeeld is vergelijkbaar met het vorige voorbeeld, behalve hoe u een waarde coderen vanuit een klasse die zich niet in het code-behind-bestand bevindt.

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

Opmerkingen

Html-codering zorgt ervoor dat tekst correct wordt weergegeven in de browser en niet wordt geïnterpreteerd door de browser als HTML. Als een tekenreeks bijvoorbeeld een teken bevat dat kleiner is dan het teken (<) of groter is dan het teken (>), interpreteert de browser deze tekens als de vierkante haak openen of sluiten van een HTML-tag. Wanneer de tekens HTML-code hebben, worden ze geconverteerd naar de tekenreeksen < en >, waardoor de browser het kleiner dan teken en groter dan het teken correct weergeeft.

Deze methode is een handige manier om toegang te krijgen tot de methode HttpUtility.HtmlEncode tijdens runtime vanuit een ASP.NET toepassing. Intern gebruikt HttpUtility.HtmlEncode deze methode om tekenreeksen te coderen.

Open in het code-behind-bestand voor een ASP.NET webpagina een exemplaar van de klasse HttpServerUtility via de eigenschap Server. Gebruik in een klasse die zich niet in een code-behind-bestand HttpContext.Current.Server bevindt, voor toegang tot een exemplaar van de HttpServerUtility klasse.

Gebruik de WebUtility klasse buiten een webtoepassing om waarden te coderen of te decoderen.

HtmlEncode(String, TextWriter)

HTML-codeert een tekenreeks en verzendt de resulterende uitvoer naar een TextWriter uitvoerstroom.

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)

Parameters

s

String

De tekenreeks die moet worden gecodeerd.

output

TextWriter

De TextWriter uitvoerstroom die de gecodeerde tekenreeks bevat.

Voorbeelden

In het volgende voorbeeld wordt een tekenreeks gecodeerd voor verzending door HTTP. Deze codeert de tekenreeks met de naam TestString, die de tekst 'Dit is een <testtekenreeks>' bevat en kopieert deze naar de tekenreeks met de naam EncodedString 'Dit is een <testreeks>'.

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()
   

Opmerkingen

HTML-codering zorgt ervoor dat tekst correct wordt weergegeven in de browser, niet geïnterpreteerd door de browser als HTML. Als een tekenreeks bijvoorbeeld een tekenreeks bevat die kleiner is dan het teken (<) of groter is dan het teken (>), interpreteert de browser deze tekens als een haakje openen of sluiten van een HTML-tag. De HTML-codering van deze twee tekens is < en >, respectievelijk, waardoor de browser de minder dan het teken en groter dan het teken correct weergeeft.

HtmlEncode is een handige manier om vanaf een ASP.NET toepassing toegang te krijgen tot de methode HttpUtility.HtmlEncode. Intern gebruikt HtmlEncodeHttpUtility.HtmlEncode voor het coderen van tekenreeksen.

Als u waarden buiten een webtoepassing wilt coderen of decoderen, gebruikt u de WebUtility klasse.