HttpUtility HttpUtility HttpUtility HttpUtility Class

Definition

Stellt Methoden zum Codieren und Decodieren von URLs bei der Verarbeitung von Webanforderungen bereit.Provides methods for encoding and decoding URLs when processing Web requests. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class HttpUtility sealed
public sealed class HttpUtility
type HttpUtility = class
Public NotInheritable Class HttpUtility
Vererbung
HttpUtilityHttpUtilityHttpUtilityHttpUtility

Beispiele

Im folgenden Codebeispiel UrlEncodewird die Verwendung der-Methode, ParseQueryString UrlDecode der-Methode HttpUtility und der-Methode der-Klasse veranschaulicht.The following code example demonstrates the use of the UrlEncode, UrlDecode and ParseQueryString methods of the HttpUtility class.

<%@ 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 Page_Load(object sender, EventArgs e)
    {
        String currurl = HttpContext.Current.Request.RawUrl;
        String querystring = null;

        // Check to make sure some query string variables
        // exist and if not add some and redirect.
        int iqs = currurl.IndexOf('?');
        if (iqs == -1)
        {
            String redirecturl = currurl + "?var1=1&var2=2+2%2f3&var1=3";
            Response.Redirect(redirecturl, true);
        }
        // If query string variables exist, put them in
        // a string.
        else if (iqs >= 0)
        {
            querystring = (iqs < currurl.Length - 1) ? currurl.Substring(iqs + 1) : String.Empty;
        }

        // Parse the query string variables into a NameValueCollection.
        NameValueCollection qscoll = HttpUtility.ParseQueryString(querystring);

        // Iterate through the collection.
        StringBuilder sb = new StringBuilder();
        foreach (String s in qscoll.AllKeys)
        {
            sb.Append(s + " - " + qscoll[s] + "<br />");
        }

        // Write the results to the appropriate labels.
        ParseOutput.Text = sb.ToString();
        UrlRawOutput.Text = currurl;
        UrlEncodedOutput.Text = HttpUtility.UrlEncode(currurl);
        UrlDecodedOutput.Text = HttpUtility.UrlDecode(currurl);
    }
</script>


<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpUtility Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      The raw url is: <br />
      <asp:Label  id="UrlRawOutput"
                  runat="server" />
      <br /><br />
      The url encoded is: <br />
      <asp:Label  id="UrlEncodedOutput"
                  runat="server" />
      <br /><br />
      The url decoded is: <br />
      <asp:Label  id="UrlDecodedOutput"
                  runat="server" />
      <br /><br />
      The query string NameValueCollection is: <br />
      <asp:Label  id="ParseOutput"
                  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 Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

        Dim currurl As String = HttpContext.Current.Request.RawUrl
        Dim querystring As String = Nothing
    
        ' Check to make sure some query string variables
        ' exist and if not add some and redirect.
        Dim iqs As Int32 = currurl.IndexOf("?".ToCharArray())
        If (iqs = -1) Then
      
            Dim redirecturl As String = currurl & "?var1=1&var2=2+2%2f3&var1=3"
            Response.Redirect(redirecturl, True)
      
            ' If query string variables exist, put them in
            ' a string.
        ElseIf (iqs >= 0) Then
      
            If (iqs < currurl.Length - 1) Then
                querystring = currurl.Substring(iqs + 1)
            End If
          
        End If

        ' Parse the query string variables into a NameValueCollection.
        Dim qscoll As NameValueCollection = HttpUtility.ParseQueryString(querystring)
    
        ' Iterate through the collection.
        Dim sb As New StringBuilder()
        For Each s As String In qscoll.AllKeys
      
            sb.Append(s & " - " & qscoll(s) & "<br />")
    
        Next s
    
        ' Write the results to the appropriate labels.
        ParseOutput.Text = sb.ToString()
        UrlRawOutput.Text = currurl
        UrlEncodedOutput.Text = HttpUtility.UrlEncode(currurl)
        UrlDecodedOutput.Text = HttpUtility.UrlDecode(currurl)
   
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpUtility Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      The raw url is: <br />
      <asp:Label  id="UrlRawOutput"
                  runat="server" />
      <br /><br />
      The url encoded is: <br />
      <asp:Label  id="UrlEncodedOutput"
                  runat="server" />
      <br /><br />
      The url decoded is: <br />
      <asp:Label  id="UrlDecodedOutput"
                  runat="server" />
      <br /><br />
      The query string NameValueCollection is: <br />
      <asp:Label  id="ParseOutput"
                  runat="server" />    
    </div>
    </form>
</body>
</html>

Hinweise

Die HttpUtility -Klasse wird intern von der HttpServerUtility -Klasse verwendet, deren Methoden und Eigenschaften über das intrinsische Server ASP.NET-Objekt verfügbar gemacht werden.The HttpUtility class is used internally by the HttpServerUtility class, whose methods and properties are exposed through the intrinsic ASP.NET Server object. Darüber hinaus enthält HttpUtility die-Klasse Codierungs-und Decodierungs Methoden, auf Serverdie nicht über zugegriffen werden kann.Additionally, the HttpUtility class contains encoding and decoding utility methods that are not accessible from the Server.

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.

Konstruktoren

HttpUtility() HttpUtility() HttpUtility() HttpUtility()

Initialisiert eine neue Instanz der HttpUtility-Klasse.Initializes a new instance of the HttpUtility class.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
HtmlAttributeEncode(String) HtmlAttributeEncode(String) HtmlAttributeEncode(String) HtmlAttributeEncode(String)

Führt eine minimale Konvertierung einer Zeichenfolge in eine HTML-codierte Zeichenfolge aus.Minimally converts a string to an HTML-encoded string.

HtmlAttributeEncode(String, TextWriter) HtmlAttributeEncode(String, TextWriter) HtmlAttributeEncode(String, TextWriter) HtmlAttributeEncode(String, TextWriter)

Konvertiert eine Zeichenfolge minimal in eine HTML-codierte Zeichenfolge und sendet die codierte Zeichenfolge dann an einen TextWriter-Ausgabestream.Minimally converts a string into an HTML-encoded string and sends the encoded string to a TextWriter output stream.

HtmlDecode(String) HtmlDecode(String) HtmlDecode(String) HtmlDecode(String)

Konvertiert eine Zeichenfolge, die für die HTTP-Übertragung HTML-codiert wurde, in eine decodierte Zeichenfolge.Converts a string that has been HTML-encoded for HTTP transmission into a decoded string.

HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter)

Konvertiert eine HTML-codierte Zeichenfolge in eine decodierte Zeichenfolge und sendet die decodierte Zeichenfolge an einen TextWriter-Ausgabestream.Converts a string that has been HTML-encoded into a decoded string, and sends the decoded string to a TextWriter output stream.

HtmlEncode(Object) HtmlEncode(Object) HtmlEncode(Object) HtmlEncode(Object)

Konvertiert die Zeichenfolgendarstellung eines Objekts in eine HTML-codierte Zeichenfolge und gibt die codierte Zeichenfolge zurück.Converts an object's string representation into an HTML-encoded string, and returns the encoded string.

HtmlEncode(String) HtmlEncode(String) HtmlEncode(String) HtmlEncode(String)

Konvertiert eine Zeichenfolge in eine HTML-codierte Zeichenfolge.Converts a string to an HTML-encoded string.

HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter)

Konvertiert eine Zeichenfolge in eine HTML-codierte Zeichenfolge und gibt das Ergebnis in Form eines TextWriter-Ausgabestreams zurück.Converts a string into an HTML-encoded string, and returns the output as a TextWriter stream of output.

JavaScriptStringEncode(String) JavaScriptStringEncode(String) JavaScriptStringEncode(String) JavaScriptStringEncode(String)

Codiert eine Zeichenfolge.Encodes a string.

JavaScriptStringEncode(String, Boolean) JavaScriptStringEncode(String, Boolean) JavaScriptStringEncode(String, Boolean) JavaScriptStringEncode(String, Boolean)

Codiert eine Zeichenfolge.Encodes a string.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ParseQueryString(String) ParseQueryString(String) ParseQueryString(String) ParseQueryString(String)

Liest eine Abfragezeichenfolge mithilfe der NameValueCollection-Codierung in eine UTF8 ein.Parses a query string into a NameValueCollection using UTF8 encoding.

ParseQueryString(String, Encoding) ParseQueryString(String, Encoding) ParseQueryString(String, Encoding) ParseQueryString(String, Encoding)

Liest eine Abfragezeichenfolge mithilfe der angegebenen NameValueCollection in eine Encoding ein.Parses a query string into a NameValueCollection using the specified Encoding.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
UrlDecode(Byte[], Encoding) UrlDecode(Byte[], Encoding) UrlDecode(Byte[], Encoding) UrlDecode(Byte[], Encoding)

Konvertiert mithilfe des angegebenen Decodierungsobjekts ein URL-codiertes Bytearray in eine decodierte Zeichenfolge.Converts a URL-encoded byte array into a decoded string using the specified decoding object.

UrlDecode(Byte[], Int32, Int32, Encoding) UrlDecode(Byte[], Int32, Int32, Encoding) UrlDecode(Byte[], Int32, Int32, Encoding) UrlDecode(Byte[], Int32, Int32, Encoding)

Konvertiert mithilfe des angegebenen Codierungsobjekts ein URL-codiertes Bytearray in eine decodierte Zeichenfolge, wobei dieser Vorgang an der angegebenen Position im Array begonnen und für die angegebene Anzahl von Bytes fortgesetzt wird.Converts a URL-encoded byte array into a decoded string using the specified encoding object, starting at the specified position in the array, and continuing for the specified number of bytes.

UrlDecode(String) UrlDecode(String) UrlDecode(String) UrlDecode(String)

Konvertiert eine Zeichenfolge, die für die Übertragung in eine URL codiert wurde, in eine decodierte Zeichenfolge.Converts a string that has been encoded for transmission in a URL into a decoded string.

UrlDecode(String, Encoding) UrlDecode(String, Encoding) UrlDecode(String, Encoding) UrlDecode(String, Encoding)

Konvertiert mithilfe des angegebenen Codierungsobjekts eine URL-codierte Zeichenfolge in eine decodierte Zeichenfolge.Converts a URL-encoded string into a decoded string, using the specified encoding object.

UrlDecodeToBytes(Byte[]) UrlDecodeToBytes(Byte[]) UrlDecodeToBytes(Byte[]) UrlDecodeToBytes(Byte[])

Konvertiert ein URL-codiertes Bytearray in ein decodiertes Bytearray.Converts a URL-encoded array of bytes into a decoded array of bytes.

UrlDecodeToBytes(Byte[], Int32, Int32) UrlDecodeToBytes(Byte[], Int32, Int32) UrlDecodeToBytes(Byte[], Int32, Int32) UrlDecodeToBytes(Byte[], Int32, Int32)

Konvertiert ein URL-codiertes Bytearray in ein decodiertes Bytearray, wobei dieser Vorgang an der angegebenen Position im Array begonnen und für die angegebene Anzahl von Bytes fortgesetzt wird.Converts a URL-encoded array of bytes into a decoded array of bytes, starting at the specified position in the array and continuing for the specified number of bytes.

UrlDecodeToBytes(String) UrlDecodeToBytes(String) UrlDecodeToBytes(String) UrlDecodeToBytes(String)

Konvertiert eine URL-codierte Zeichenfolge in ein decodiertes Bytearray.Converts a URL-encoded string into a decoded array of bytes.

UrlDecodeToBytes(String, Encoding) UrlDecodeToBytes(String, Encoding) UrlDecodeToBytes(String, Encoding) UrlDecodeToBytes(String, Encoding)

Konvertiert mithilfe des angegebenen Decodierungsobjekts eine URL-codierte Zeichenfolge in ein decodiertes Bytearray.Converts a URL-encoded string into a decoded array of bytes using the specified decoding object.

UrlEncode(Byte[]) UrlEncode(Byte[]) UrlEncode(Byte[]) UrlEncode(Byte[])

Konvertiert ein Bytearray in eine codierte URL-Zeichenfolge.Converts a byte array into an encoded URL string.

UrlEncode(Byte[], Int32, Int32) UrlEncode(Byte[], Int32, Int32) UrlEncode(Byte[], Int32, Int32) UrlEncode(Byte[], Int32, Int32)

Konvertiert ein Bytearray in eine URL-codierte Zeichenfolge, wobei dieser Vorgang an der angegebenen Position im Array begonnen und für die angegebene Anzahl von Bytes fortgesetzt wird.Converts a byte array into a URL-encoded string, starting at the specified position in the array and continuing for the specified number of bytes.

UrlEncode(String) UrlEncode(String) UrlEncode(String) UrlEncode(String)

Codiert eine URL-Zeichenfolge.Encodes a URL string.

UrlEncode(String, Encoding) UrlEncode(String, Encoding) UrlEncode(String, Encoding) UrlEncode(String, Encoding)

Codiert mithilfe des angegebenen Codierungsobjekts eine URL-Zeichenfolge.Encodes a URL string using the specified encoding object.

UrlEncodeToBytes(Byte[]) UrlEncodeToBytes(Byte[]) UrlEncodeToBytes(Byte[]) UrlEncodeToBytes(Byte[])

Konvertiert ein Bytearray in ein URL-codiertes Bytearray.Converts an array of bytes into a URL-encoded array of bytes.

UrlEncodeToBytes(Byte[], Int32, Int32) UrlEncodeToBytes(Byte[], Int32, Int32) UrlEncodeToBytes(Byte[], Int32, Int32) UrlEncodeToBytes(Byte[], Int32, Int32)

Konvertiert ein Bytearray in ein URL-codiertes Bytearray, wobei dieser Vorgang an der angegebenen Position im Array begonnen und für die angegebene Anzahl von Bytes fortgesetzt wird.Converts an array of bytes into a URL-encoded array of bytes, starting at the specified position in the array and continuing for the specified number of bytes.

UrlEncodeToBytes(String) UrlEncodeToBytes(String) UrlEncodeToBytes(String) UrlEncodeToBytes(String)

Konvertiert eine Zeichenfolge in ein URL-codiertes Bytearray.Converts a string into a URL-encoded array of bytes.

UrlEncodeToBytes(String, Encoding) UrlEncodeToBytes(String, Encoding) UrlEncodeToBytes(String, Encoding) UrlEncodeToBytes(String, Encoding)

Konvertiert mithilfe des angegebenen Codierungsobjekts eine Zeichenfolge in ein URL-codiertes Bytearray.Converts a string into a URL-encoded array of bytes using the specified encoding object.

UrlEncodeUnicode(String) UrlEncodeUnicode(String) UrlEncodeUnicode(String) UrlEncodeUnicode(String)

Konvertiert eine Zeichenfolge in eine Unicode-Zeichenfolge.Converts a string into a Unicode string.

UrlEncodeUnicodeToBytes(String) UrlEncodeUnicodeToBytes(String) UrlEncodeUnicodeToBytes(String) UrlEncodeUnicodeToBytes(String)

Konvertiert eine Unicode-Zeichenfolge in ein Bytearray.Converts a Unicode string into an array of bytes.

UrlPathEncode(String) UrlPathEncode(String) UrlPathEncode(String) UrlPathEncode(String)

Nicht verwenden. Nur für die Browserkompatibilität vorgesehen.Do not use; intended only for browser compatibility. Verwenden Sie UrlEncode(String).Use UrlEncode(String).

Gilt für:

Siehe auch