HttpServerUtility Klasse

Definition

Stellt Hilfsmethoden für die Verarbeitung von Webanforderungen zur Verfügung.

public ref class HttpServerUtility sealed
public sealed class HttpServerUtility
type HttpServerUtility = class
Public NotInheritable Class HttpServerUtility
Vererbung
HttpServerUtility

Beispiele

Ein Visual Studio Websiteprojekt mit Quellcode ist verfügbar, um dieses Thema zu begleiten: Herunterladen.

Im folgenden Beispiel wird veranschaulicht, wie Sie die HtmlEncode Methode und die UrlEncode Methode der HttpServerUtility Klasse verwenden. Die HtmlEncode Methode hilft sicherzustellen, dass alle vom Benutzer bereitgestellten Zeichenfolgeneingaben in Browsern anstelle von ausführbaren Skripts oder HTML-Elementen als statischer Text gerendert werden. Die UrlEncode Methode codiert URLs, sodass sie im HTTP-Stream ordnungsgemäß übertragen werden.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Button1_Click(object sender, EventArgs e)
    {
        if (!String.IsNullOrEmpty(TextBox1.Text))
        {
            // Access the HttpServerUtility methods through
            // the intrinsic Server object.
            Label1.Text = "Welcome, " +
                Server.HtmlEncode(TextBox1.Text) +
                ".<br/> The url is " + 
                Server.UrlEncode(Request.Url.ToString());
        }
    }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpServerUtility Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Enter your name:<br />

        <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
        <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="Submit" />
        <br />
        <asp:Label ID="Label1" runat="server"/>
        </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)

        If (Not String.IsNullOrEmpty(TextBox1.Text)) Then
            
            ' Access the HttpServerUtility methods through
            ' the intrinsic Server object.
            Label1.Text = "Welcome, " & _
                Server.HtmlEncode(TextBox1.Text) & _
                ".<br/> The url is " & _
                Server.UrlEncode(Request.Url.ToString())
        End If
        
        
        
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>HttpServerUtility Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        Enter your name:<br />

        <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
        <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="Submit" />
        <br />
        <asp:Label ID="Label1" runat="server"/>
        </div>
    </form>
</body>
</html>

Hinweise

Die Methoden und Eigenschaften der HttpServerUtility Klasse werden über das systeminterne Server Objekt verfügbar gemacht, das von ASP.NET bereitgestellt wird.

Eigenschaften

MachineName

Ruft den Computernamen des Servers ab.

ScriptTimeout

Ruft den Timeoutwert der Anforderung (in Sekunden) ab oder legt diesen fest.

Methoden

ClearError()

Löscht die vorhergehende Ausnahme.

CreateObject(String)

Erstellt eine Serverinstanz eines COM-Objekts, das durch den Programmbezeichner (ProgID) des Objekts gekennzeichnet ist.

CreateObject(Type)

Erstellt eine Serverinstanz eines COM-Objekts, das durch den Objekttyp identifiziert wird.

CreateObjectFromClsid(String)

Erstellt eine Serverinstanz eines COM-Objekts, das durch die Klassen-ID (Class Identifier, CLSID) des Objekts gekennzeichnet ist.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
Execute(IHttpHandler, TextWriter, Boolean)

Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus. Ein TextWriter zeichnet die Ausgabe des ausgeführten Handlers auf, und ein boolescher Parameter gibt an, ob die QueryString-Auflistung und die Form-Auflistung gelöscht werden sollen.

Execute(String)

Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus.

Execute(String, Boolean)

Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus und gibt an, ob die QueryString-Auflistung und die Form-Auflistung gelöscht werden sollen.

Execute(String, TextWriter)

Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus. Ein TextWriter zeichnet die Ausgabe des ausgeführten Handlers auf.

Execute(String, TextWriter, Boolean)

Führt den Handler für den angegebenen virtuellen Pfad im Kontext der aktuellen Anforderung aus. Ein TextWriter zeichnet die Ausgabe der Seite auf, und ein boolescher Parameter gibt an, ob die QueryString-Auflistung und die Form-Auflistung gelöscht werden sollen.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLastError()

Gibt die vorhergehende Ausnahme zurück.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
HtmlDecode(String)

Decodiert eine HTML-codierte Zeichenfolge und gibt die decodierte Zeichenfolge zurück.

HtmlDecode(String, TextWriter)

Decodiert eine HTML-codierte Zeichenfolge und sendet die Ausgabe an einen TextWriter-Ausgabestream.

HtmlEncode(String)

Codiert eine Zeichenfolge in HTML und gibt diese codiert zurück.

HtmlEncode(String, TextWriter)

Codiert eine Zeichenfolge in HTML und sendet die Ausgabe an einen TextWriter-Ausgabestream.

MapPath(String)

Gibt den physischen Dateipfad zurück, der dem angegebenen virtuellen Pfad entspricht.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
Transfer(IHttpHandler, Boolean)

Beendet die Ausführung der aktuellen Seite und beginnt die Ausführung einer neuen Anforderung mithilfe eines benutzerdefinierten HTTP-Handlers, der die IHttpHandler-Schnittstelle implementiert und angibt, ob die QueryString-Auflistung und die Form-Auflistung gelöscht werden sollen.

Transfer(String)

Beendet für die aktuelle Anforderung die Ausführung der aktuellen Seite und startet die Ausführung einer neuen Seite unter Verwendung des angegebenen URL-Pfads für die Seite.

Transfer(String, Boolean)

Beendet die Ausführung der aktuellen Seite und startet die Ausführung einer neuen Seite unter Verwendung des angegebenen URL-Pfads für die Seite. Gibt an, ob die QueryString-Auflistung und die Form-Auflistung gelöscht werden soll.

TransferRequest(String)

Führt die angegebene URL asynchron aus.

TransferRequest(String, Boolean)

Führt die angegebene URL asynchron aus und behält die Parameter der Abfragezeichenfolge bei.

TransferRequest(String, Boolean, String, NameValueCollection)

Führt die angegebene URL mit der angegebenen HTTP-Methode und den angegebenen HTTP-Headern asynchron aus.

TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

Nimmt eine asynchrone Ausführung der angegebenen URL mit der angegebenen HTTP-Methode, den angegebenen HTTP-Headern und dem angegebenen HTTP-Pfad vor und behält die Formularwerte und Benutzeridentität optional bei.

UrlDecode(String)

Decodiert eine URL-Zeichenfolge und gibt die decodierte Zeichenfolge zurück.

UrlDecode(String, TextWriter)

Decodiert eine HTML-Zeichenfolge, die in einer URL empfangen wurde, und sendet die Ausgabe an einen TextWriter-Ausgabestream.

UrlEncode(String)

Codiert eine Zeichenfolge als URL und gibt die codierte Zeichenfolge zurück.

UrlEncode(String, TextWriter)

Codiert eine Zeichenfolge als URL und sendet die Ausgabe an einen TextWriter-Ausgabestream.

UrlPathEncode(String)

Nicht verwenden. Nur für die Browserkompatibilität vorgesehen. Verwenden Sie UrlEncode(String).

UrlTokenDecode(String)

Decodiert ein URL-Zeichenfolgentoken in sein entsprechendes Bytearray mit Base-64-Ziffern.

UrlTokenEncode(Byte[])

Codiert ein Bytearray in seine äquivalente Zeichenfolgendarstellung mit Base-64-Ziffern, die für die Übertragung in der URL geeignet ist.

Gilt für

Siehe auch