HttpServerUtility.HtmlEncode Metódus

Definíció

Névtér:

System.Web

Szerelvény:

System.Web.dll

Kódolja a böngészőben megjelenítendő sztringet.

Ha webalkalmazáson kívüli értékeket szeretne kódolni vagy dekódolni, használja az osztályt WebUtility .

Túlterhelések

Name	Description
HtmlEncode(String)	A HTML kódol egy sztringet, és visszaadja a kódolt sztringet.
HtmlEncode(String, TextWriter)	A HTML kódol egy sztringet, és elküldi az eredményül kapott kimenetet egy TextWriter kimeneti streamnek.

HtmlEncode(String)

A HTML kódol egy sztringet, és visszaadja a kódolt sztringet.

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

Paraméterek

s

String

A kódolni kívánt szöveges sztring.

Válaszok

String

A HTML-kódolt szöveg.

Példák

Az alábbi példa bemutatja, hogyan kódolhat HTML-kódolással egy olyan értéket, amely potenciálisan nem biztonságos kódot kódol. A kód egy weblap kód mögötti fájljában található. A kódolandó érték ebben a példában csak a példa egyszerűsítése és a HTML-kódolású érték típusának megjelenítése érdekében van kódolva. A HTML-kód általában a felhasználótól vagy a kéréstől kapott értéket fogja kódolni. Result vezérlőelemre Literal hivatkozik.

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

A következő példa hasonló az előző példához, kivéve, ha azt mutatja be, hogyan kódolhat html-kódolást egy olyan osztályból, amely nem szerepel a kód mögötti fájlban.

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

Megjegyzések

A HTML-kódolás gondoskodik arról, hogy a szöveg megfelelően jelenjen meg a böngészőben, és a böngésző ne értelmezi HTML-ként. Ha például egy szöveges sztring kisebb előjelet (<) vagy nagyobbat tartalmaz, mint a jel (>), a böngésző ezeket a karaktereket egy HTML-címke nyitó vagy záró zárójeleként értelmezi. Ha a karakterek HTML-kódolásúak, a rendszer sztringekké <>alakítja őket, és emiatt a böngésző a kisebb, mint a jel, és nagyobb lesz, mint a megfelelő jel.

Ezzel a módszerrel kényelmesen elérheti a HttpUtility.HtmlEncode metódust futásidőben egy ASP.NET alkalmazásból. Ez a módszer belsőleg sztringek kódolására használja HttpUtility.HtmlEncode .

Egy ASP.NET weblap kód mögötti fájljában a HttpServerUtility osztály egy példányát a Server tulajdonságon keresztül érheti el. Egy olyan osztályban, amely nem kód mögötti fájlban található, az osztály egy példányának HttpServerUtility eléréséhez használhatóHttpContext.Current.Server.

A webalkalmazáson kívül az osztály használatával kódolhatja vagy dekódolhatja az WebUtility értékeket.

HtmlEncode(String, TextWriter)

A HTML kódol egy sztringet, és elküldi az eredményül kapott kimenetet egy TextWriter kimeneti streamnek.

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)

Paraméterek

s

String

A kódolandó sztring.

output

TextWriter

A TextWriter kódolt sztringet tartalmazó kimeneti adatfolyam.

Példák

Az alábbi példa egy sztringet kódol a HTTP általi átvitelhez. Kódolja az "TestStringEz egy tesztsztring>" szöveget tartalmazó sztringet<, és a "Ez egy tesztsztring>" néven elnevezett EncodedString sztringbe <másolja.

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

Megjegyzések

A HTML-kódolás biztosítja, hogy a szöveg helyesen jelenjen meg a böngészőben, a böngésző nem HTML-ként értelmezi. Ha például egy szöveges sztring kisebb előjelet () vagy nagyobbat tartalmaz, mint a jel (<>), a böngésző ezeket a karaktereket egy HTML-címke nyitó vagy záró zárójeleként értelmezi. Ennek a két karakternek a HTML-kódolása a <>böngészőben az előjelnél kisebb és nagyobb, mint a megfelelő jel.

A HtmlEncode egy ASP.NET-alkalmazás futásidejű HttpUtility.HtmlEncode metódusának kényelmes elérése. Belsőleg HtmlEncode sztringek kódolására használ HttpUtility.HtmlEncode .

Ha webalkalmazáson kívüli értékeket szeretne kódolni vagy dekódolni, használja az osztályt WebUtility .