HttpServerUtility.HtmlEncode Methode

Definition

Codiert eine Zeichenfolge, die in einem Browser angezeigt werden soll.Encodes a string to be displayed in a browser.

Verwenden Sie zum Codieren oder Decodieren von Werten außerhalb einer Webanwendung die WebUtility-Klasse.To encode or decode values outside of a web application, use the WebUtility class.

Überlädt

HtmlEncode(String)

Codiert eine Zeichenfolge in HTML und gibt diese codiert zurück.HTML-encodes a string and returns the encoded string.

HtmlEncode(String, TextWriter)

Codiert eine Zeichenfolge in HTML und sendet die Ausgabe an einen TextWriter-Ausgabestream.HTML-encodes a string and sends the resulting output to a TextWriter output stream.

HtmlEncode(String)

Codiert eine Zeichenfolge in HTML und gibt diese codiert zurück.HTML-encodes a string and returns the encoded string.

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

Parameter

s
String

Die zu codierende Textzeichenfolge.The text string to encode.

Gibt zurück

Der HTML-codierte Text.The HTML-encoded text.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein Wert, der potenziell unsicheren Code codiert, von einem HTML-codiert wird.The following example shows how to HTML-encode a value that potentially codes unsafe code. Der Code befindet sich in der Code-Behind-Datei für eine Webseite.The code resides in the code-behind file for a web page. Der zu codierende Wert ist nur in diesem Beispiel hart codiert, um das Beispiel zu vereinfachen und den Typ des Werts anzuzeigen, den Sie in HTML-codieren können.The value to encode is hard-coded in this example only to simplify the example and show the type of value you might HTML-encode. In der Regel würden Sie einen Wert, den Sie vom Benutzer oder von der Anforderung erhalten haben, HTML-codieren.Typically, you would HTML-encode a value that you received from the user or the request. Resultverweist auf ein Literal -Steuerelement.Result refers to a Literal control.

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

Das nächste Beispiel ähnelt dem vorherigen Beispiel, aber es zeigt, wie ein Wert in einer Klasse, die nicht in der Code Behind-Datei ist, in HTML-codiert wird.The next example is similar to the previous example except it shows how to HTML-encode a value from within a class that is not in the code-behind file.

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

Hinweise

Die HTML-Codierung stellt sicher, dass der Text im Browser korrekt angezeigt und nicht vom Browser als HTML interpretiert wird.HTML encoding makes sure that text is displayed correctly in the browser and not interpreted by the browser as HTML. Wenn eine Text Zeichenfolge z. b. ein kleiner-<als-Zeichen () oder ein größer-als-Zeichen (>) enthält, interpretiert der Browser diese Zeichen als öffnende oder schließende Klammer eines HTML-Tags.For example, if a text string contains a less than sign (<) or greater than sign (>), the browser would interpret these characters as the opening or closing bracket of an HTML tag. Wenn die Zeichen HTML &lt; -codiert sind, werden Sie in die Zeichen folgen und &gt;konvertiert. Dies bewirkt, dass der Browser das kleiner-als-Zeichen und das größer als-Zeichen korrekt anzeigt.When the characters are HTML encoded, they are converted to the strings &lt; and &gt;, which causes the browser to display the less than sign and greater than sign correctly.

Diese Methode ist eine bequeme Möglichkeit, zur Laufzeit HttpUtility.HtmlEncode von einer ASP.NET-Anwendung aus auf die Methode zuzugreifen.This method is a convenient way to access the HttpUtility.HtmlEncode method at run time from an ASP.NET application. Intern verwendet HttpUtility.HtmlEncode diese Methode, um Zeichen folgen zu codieren.Internally, this method uses HttpUtility.HtmlEncode to encode strings.

Greifen Sie in der Code Behind-Datei für eine ASP.NET-Webseite mithilfe der HttpServerUtility Server -Eigenschaft auf eine Instanz der-Klasse zu.In the code-behind file for an ASP.NET web page, access an instance of the HttpServerUtility class through the Server property. Verwenden HttpContext.Current.Server Sie in einer Klasse, die sich nicht in einer Code Behind-Datei befindet, für den HttpServerUtility Zugriff auf eine Instanz der-Klasse.In a class that is not in a code-behind file, use HttpContext.Current.Server to access an instance of the HttpServerUtility class.

Verwenden Sie außerhalb einer Webanwendung die WebUtility -Klasse, um Werte zu codieren oder zu decodieren.Outside of a web application, use the WebUtility class to encode or decode values.

HtmlEncode(String, TextWriter)

Codiert eine Zeichenfolge in HTML und sendet die Ausgabe an einen TextWriter-Ausgabestream.HTML-encodes a string and sends the resulting output to a TextWriter output stream.

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)

Parameter

s
String

Die zu codierende Zeichenfolge.The string to encode.

output
TextWriter

Der TextWriter-Ausgabestream, der die kodierte Zeichenfolge enthält.The TextWriter output stream that contains the encoded string.

Beispiele

Im folgenden Beispiel wird eine Zeichenfolge für die Übertragung durch HTTP codiert.The following example encodes a string for transmission by HTTP. Sie codiert die Zeichenfolge TestStringmit dem Namen, die den Text "This <is a TestString >" enthält, und kopiert EncodedString ihn in die Zeichenfolge "This is <a Test>String".It encodes the string named TestString, which contains the text "This is a <Test String>.", and copies it into the string named EncodedString as "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()
   

Hinweise

Die HTML-Codierung stellt sicher, dass der Text im Browser ordnungsgemäß angezeigt wird, und nicht vom Browser als HTML interpretiert wird.HTML encoding ensures that text will be correctly displayed in the browser, not interpreted by the browser as HTML. Wenn eine Text Zeichenfolge z. b. ein kleiner-<als-Zeichen () oder ein größer-als-Zeichen (>) enthält, interpretiert der Browser diese Zeichen als öffnende oder schließende Klammer eines HTML-Tags.For example, if a text string contains a less than sign (<) or greater than sign (>), the browser would interpret these characters as an opening or closing bracket of an HTML tag. Die HTML-Codierung dieser zwei Zeichen ist &lt; &gt;bzw., was bewirkt, dass der Browser das kleiner-als-Vorzeichen und das größer als-Zeichen korrekt anzeigt.The HTML encoding of these two characters is &lt; and &gt;, respectively, which causes the browser to display the less than sign and greater than sign correctly.

HtmlEncodeist eine bequeme Möglichkeit, zur Laufzeit HttpUtility.HtmlEncode von einer ASP.NET-Anwendung aus auf die Methode zuzugreifen.HtmlEncode is a convenient way to access the HttpUtility.HtmlEncode method at run time from an ASP.NET application. HtmlEncode Intern verwendet HttpUtility.HtmlEncode , um Zeichen folgen zu codieren.Internally, HtmlEncode uses HttpUtility.HtmlEncode to encode strings.

Verwenden Sie zum Codieren oder Decodieren von Werten außerhalb einer Webanwendung die WebUtility-Klasse.To encode or decode values outside of a web application, use the WebUtility class.

Gilt für: