HttpUtility Classe

Definizione

Fornisce metodi per la codifica e la decodifica degli URL durante l'elaborazione delle richieste Web.Provides methods for encoding and decoding URLs when processing Web requests. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class HttpUtility sealed
public sealed class HttpUtility
type HttpUtility = class
Public NotInheritable Class HttpUtility
Ereditarietà
HttpUtility

Esempi

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo dei metodi UrlEncode, UrlDecode e ParseQueryString della classe HttpUtility.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>

Commenti

La classe HttpUtility viene utilizzata internamente dalla classe HttpServerUtility, i cui metodi e proprietà vengono esposti tramite l'oggetto ASP.NET Server intrinseco.The HttpUtility class is used internally by the HttpServerUtility class, whose methods and properties are exposed through the intrinsic ASP.NET Server object. Inoltre, la classe HttpUtility contiene metodi di utilità di codifica e decodifica che non sono accessibili dall'Server.Additionally, the HttpUtility class contains encoding and decoding utility methods that are not accessible from the Server.

Per codificare o decodificare i valori al di fuori di un'applicazione Web, usare la classe WebUtility.To encode or decode values outside of a web application, use the WebUtility class.

Costruttori

HttpUtility()

Inizializza una nuova istanza della classe HttpUtility.Initializes a new instance of the HttpUtility class.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
HtmlAttributeEncode(String)

Esegue la conversione minima di una stringa in una stringa con codifica HTML.Minimally converts a string to an HTML-encoded string.

HtmlAttributeEncode(String, TextWriter)

Esegue la conversione minima di una stringa in una stringa con codifica HTML e invia la stringa codificata a un flusso di output TextWriter.Minimally converts a string into an HTML-encoded string and sends the encoded string to a TextWriter output stream.

HtmlDecode(String)

Converte una stringa che è stata codificata in formato HTML per la trasmissione HTTP in una stringa decodificata.Converts a string that has been HTML-encoded for HTTP transmission into a decoded string.

HtmlDecode(String, TextWriter)

Converte una stringa in una stringa con codifica HTML e in una stringa decodificata e invia la stringa decodificata a un flusso di output TextWriter.Converts a string that has been HTML-encoded into a decoded string, and sends the decoded string to a TextWriter output stream.

HtmlEncode(Object)

Converte la rappresentazione di stringa di un oggetto in una stringa codificata in formato HTML e restituisce la stringa codificata.Converts an object's string representation into an HTML-encoded string, and returns the encoded string.

HtmlEncode(String)

Esegue la conversione di una stringa in una stringa con codifica HTML.Converts a string to an HTML-encoded string.

HtmlEncode(String, TextWriter)

Converte una stringa in una stringa codificata in formato HTML e restituisce l'output come un flusso di output TextWriter.Converts a string into an HTML-encoded string, and returns the output as a TextWriter stream of output.

JavaScriptStringEncode(String)

Esegue la codifica di una stringa.Encodes a string.

JavaScriptStringEncode(String, Boolean)

Esegue la codifica di una stringa.Encodes a string.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ParseQueryString(String)

Analizza una stringa di query in un NameValueCollection usando la codifica UTF8.Parses a query string into a NameValueCollection using UTF8 encoding.

ParseQueryString(String, Encoding)

Analizza una stringa di query in un NameValueCollection usando l'oggetto Encoding specificato.Parses a query string into a NameValueCollection using the specified Encoding.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
UrlDecode(Byte[], Encoding)

Converte una matrice di byte con codifica URL in una stringa decodificata usando l'oggetto di decodifica specificato.Converts a URL-encoded byte array into a decoded string using the specified decoding object.

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

Converte una matrice di byte codificata in URL in una stringa decodificata usando il metodo di codifica specificato, a partire dalla posizione specificata nella matrice e continuando per il numero di byte specificato.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)

Converte una stringa che è stata codificata per la trasmissione in un URL in una stringa decodificata.Converts a string that has been encoded for transmission in a URL into a decoded string.

UrlDecode(String, Encoding)

Converte una stringa codificata in URL in una stringa decodificata usando l'oggetto di codifica specificato.Converts a URL-encoded string into a decoded string, using the specified encoding object.

UrlDecodeToBytes(Byte[])

Converte una matrice di byte codificata in URL in una matrice di byte decodificata.Converts a URL-encoded array of bytes into a decoded array of bytes.

UrlDecodeToBytes(Byte[], Int32, Int32)

Converte una matrice di byte codificata in URL in una matrice di byte decodificata, a partire dalla posizione specificata nella matrice e continuando per il numero di byte specificato.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)

Converte una stringa con codifica URL in una matrice di byte decodificata.Converts a URL-encoded string into a decoded array of bytes.

UrlDecodeToBytes(String, Encoding)

Converte una stringa con codifica URL in una matrice di byte decodificata usando l'oggetto di decodifica specificato.Converts a URL-encoded string into a decoded array of bytes using the specified decoding object.

UrlEncode(Byte[])

Converte una matrice di byte in una stringa URL codificata.Converts a byte array into an encoded URL string.

UrlEncode(Byte[], Int32, Int32)

Converte una matrice di byte in una stringa con codifica URL, a partire dalla posizione specificata nella matrice e continuando per il numero di byte specificato.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)

Codifica una stringa URL.Encodes a URL string.

UrlEncode(String, Encoding)

Consente di codificare una stringa URL usando l'oggetto di codifica specificato.Encodes a URL string using the specified encoding object.

UrlEncodeToBytes(Byte[])

Converte una matrice di byte in una matrice di byte codificata in URL.Converts an array of bytes into a URL-encoded array of bytes.

UrlEncodeToBytes(Byte[], Int32, Int32)

Converte una matrice di byte in una matrice di byte codificata in URL, a partire dalla posizione specificata nella matrice e continuando per il numero di byte specificato.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)

Consente di convertire una stringa in una matrice di byte codificata in URL.Converts a string into a URL-encoded array of bytes.

UrlEncodeToBytes(String, Encoding)

Converte una stringa in una matrice di byte codificata in URL usando l'oggetto di codifica specificato.Converts a string into a URL-encoded array of bytes using the specified encoding object.

UrlEncodeUnicode(String)

Converte una stringa in una stringa Unicode.Converts a string into a Unicode string.

UrlEncodeUnicodeToBytes(String)

Converte una stringa Unicode in una matrice di byte.Converts a Unicode string into an array of bytes.

UrlPathEncode(String)

Non usare. Progettato solo per compatibilità browser.Do not use; intended only for browser compatibility. Usare UrlEncode(String).Use UrlEncode(String).

Si applica a

Vedi anche