HttpUtility Osztály

Definíció

Névtér:
System.Web
Szerelvények:
netstandard.dll, System.Web.HttpUtility.dll
Szerelvény:
System.Web.HttpUtility.dll
Szerelvény:
System.Web.dll
Szerelvények:
System.Web.dll, System.Web.Services.dll
Szerelvény:
netstandard.dll
Forrás:
HttpUtility.cs
Forrás:
HttpUtility.cs
Forrás:
HttpUtility.cs
Forrás:
HttpUtility.cs
Forrás:
HttpUtility.cs

Metódusokat biztosít az URL-címek kódolására és dekódolására webes kérések feldolgozásakor. Ez az osztály nem örökölhető.

public ref class HttpUtility sealed
public sealed class HttpUtility
type HttpUtility = class
Public NotInheritable Class HttpUtility
Öröklődés
Object
HttpUtility

Példák

Az alábbi példakód bemutatja az osztály és UrlEncodeUrlDecode a ParseQueryStringmetódusok HttpUtility használatát.

<%@ 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>

Megjegyzések

A HttpUtility osztályt belsőleg használja a HttpServerUtility osztály, amelynek metódusai és tulajdonságai a belső ASP.NET Server objektumon keresztül érhetők el. Az osztály emellett olyan HttpUtility kódolási és dekódolási segédprogramokat is tartalmaz, amelyek nem érhetők el a Server.

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

Konstruktorok

Name Description
HttpUtility()

Inicializálja a HttpUtility osztály új példányát.

Metódusok

Name Description
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
HtmlAttributeEncode(String, TextWriter)

A sztringeket minimálisan HTML-kódolt sztringgé alakítja át, és a kódolt sztringet egy TextWriter kimeneti streambe küldi.
HtmlAttributeEncode(String)

Egy sztringet minimálisan HTML-kódolású sztringgé alakít át.
HtmlDecode(String, TextWriter)

A HTML-kóddal kódolt sztringeket dekódolt sztringgé alakítja át, és elküldi a dekódolt sztringet egy TextWriter kimeneti adatfolyamnak.
HtmlDecode(String)

A HTTP-átvitelhez HTML-kóddal kódolt sztringet dekódolt sztringgé alakítja át.
HtmlEncode(Object)

Egy objektum sztringképét HTML-kóddal ellátott sztringgé alakítja át, és visszaadja a kódolt sztringet.
HtmlEncode(String, TextWriter)

A sztringet HTML-kóddal kódolt sztringgé alakítja át, és kimenetfolyamként TextWriter adja vissza a kimenetet.
HtmlEncode(String)

Egy sztringet HTML-kóddal kódolt sztringgé alakít át.
JavaScriptStringEncode(String, Boolean)

Sztringet kódol.
JavaScriptStringEncode(String)

Sztringet kódol.
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
ParseQueryString(String, Encoding)

Egy lekérdezési sztring elemzése a NameValueCollection megadott Encodinghasználatával.
ParseQueryString(String)

Egy lekérdezési sztringet kódolással NameValueCollectionUTF8 elemez.
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)
UrlDecode(Byte[], Encoding)

Az URL-kódolású bájttömböket dekódolt sztringgé alakítja a megadott dekódoló objektummal.
UrlDecode(Byte[], Int32, Int32, Encoding)

Az URL-kódolású bájttömböket dekódolt sztringgé alakítja a megadott kódolási objektummal, a tömb megadott pozíciójától kezdve a megadott számú bájtig.
UrlDecode(String, Encoding)

Az URL-kódolású sztringeket dekódolt sztringgé alakítja a megadott kódolási objektummal.
UrlDecode(String)

Dekódolt sztringgé alakítja az URL-címben való átvitelhez kódolt sztringet.
UrlDecodeToBytes(Byte[], Int32, Int32)

A bájtok URL-kódolású tömbjének konvertálása bájtok dekódolt tömbjeként, a tömb megadott pozíciójától kezdve a megadott számú bájtig.
UrlDecodeToBytes(Byte[])

Bájtok URL-kódolású tömbjének konvertálása bájtok dekódolt tömbjeivé.
UrlDecodeToBytes(String, Encoding)

Az URL-kódolású sztringeket bájtok dekódolt tömbjeként alakítja át a megadott dekódoló objektummal.
UrlDecodeToBytes(String)

Egy URL-kódolású sztringet bájtok dekódolt tömbjeként alakít át.
UrlEncode(Byte[], Int32, Int32)

Egy bájttömböt URL-kódolt sztringgé alakít át, amely a tömb megadott pozíciójától kezdve a megadott bájtszámmal folytatódik.
UrlEncode(Byte[])

Egy bájttömböt kódolt URL-sztringgé alakít át.
UrlEncode(String, Encoding)

Egy URL-sztringet kódol a megadott kódolási objektummal.
UrlEncode(String)

URL-sztringet kódol.
UrlEncodeToBytes(Byte[], Int32, Int32)

Bájttömböt konvertál egy URL-cím által kódolt bájttömbbe, a tömb megadott pozíciójától kezdve a megadott számú bájtig.
UrlEncodeToBytes(Byte[])

Bájttömböt konvertál url-kódolt bájtok tömbjeként.
UrlEncodeToBytes(String, Encoding)

Egy sztringet a megadott kódolási objektummal url-kódolású bájtok tömbjeként alakít át.
UrlEncodeToBytes(String)

A sztringet bájtok URL-címekkel kódolt tömbjeként alakítja át.
UrlEncodeUnicode(String)
Elavult.

Unicode-sztringgé alakít át egy sztringet.
UrlEncodeUnicodeToBytes(String)
Elavult.

Unicode-sztringet konvertál bájtok tömbjeként.
UrlPathEncode(String)

Ne használja; csak böngészőkompatibilitásra szolgál. Használja a UrlEncode(String).

A következőre érvényes:

Lásd még