HttpUtility HttpUtility HttpUtility HttpUtility Class

Définition

Fournit des méthodes de codage et décodage d'URL pendant le traitement des requêtes web.Provides methods for encoding and decoding URLs when processing Web requests. Cette classe ne peut pas être héritée.This class cannot be inherited.

public ref class HttpUtility sealed
public sealed class HttpUtility
type HttpUtility = class
Public NotInheritable Class HttpUtility
Héritage
HttpUtilityHttpUtilityHttpUtilityHttpUtility

Exemples

L’exemple de code suivant illustre l’utilisation de la UrlEncode, UrlDecode et ParseQueryString méthodes de la HttpUtility classe.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>

Remarques

Le HttpUtility classe est utilisée en interne par le HttpServerUtility (classe), dont les méthodes et propriétés est exposée via ASP.NET intrinsèque Server objet.The HttpUtility class is used internally by the HttpServerUtility class, whose methods and properties are exposed through the intrinsic ASP.NET Server object. En outre, le HttpUtility classe contient l’encodage et décodage des méthodes utilitaires qui ne sont pas accessibles à partir de la Server.Additionally, the HttpUtility class contains encoding and decoding utility methods that are not accessible from the Server.

Pour coder ou décoder les valeurs en dehors d’une application web, utilisez la classe WebUtility.To encode or decode values outside of a web application, use the WebUtility class.

Constructeurs

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

Initialise une nouvelle instance de la classe HttpUtility.Initializes a new instance of the HttpUtility class.

Méthodes

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

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

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

Fait office de fonction de hachage par défaut.Serves as the default hash function.

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

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

Effectue une conversion minimale d’une chaîne en une chaîne encodée au format HTML.Minimally converts a string to an HTML-encoded string.

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

Convertit de façon minimale une chaîne en chaîne encodée en HTML, puis envoie la chaîne encodée à un flux de sortie TextWriter.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)

Convertit une chaîne qui a été encodée en HTML en vue d’une transmission HTML dans une chaîne décodée.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)

Convertit une chaîne qui a été encodée en HTML en chaîne décodée et envoie la chaîne décodée à un flux de sortie 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) HtmlEncode(Object) HtmlEncode(Object) HtmlEncode(Object)

Convertit la représentation sous forme de chaîne d’un objet en chaîne encodée en HTML et retourne la chaîne encodée.Converts an object's string representation into an HTML-encoded string, and returns the encoded string.

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

Convertit une chaîne en une chaîne encodée au format HTML.Converts a string to an HTML-encoded string.

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

Convertit une chaîne en une chaîne encodée au format HTML, et retourne la sortie en tant que flux de sortie TextWriter.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)

Encode une chaîne.Encodes a string.

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

Encode une chaîne.Encodes a string.

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

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

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

Analyse une chaîne de requête dans NameValueCollection à l'aide de l'encodage UTF8.Parses a query string into a NameValueCollection using UTF8 encoding.

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

Analyse une chaîne de requête dans NameValueCollection à l'aide du Encoding spécifié.Parses a query string into a NameValueCollection using the specified Encoding.

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

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

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

Convertit en chaîne décodée un tableau d'octets encodé URL, à l'aide de l'objet de décodage spécifié.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)

Convertit un tableau d'octets encodé URL en chaîne décodée, à l'aide de l'objet d'encodage spécifié, en commençant à l'emplacement spécifié dans le tableau et en continuant pour le nombre d'octets spécifié.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)

Convertit en chaîne décodée une chaîne qui a été encodée pour une transmission dans une URL.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)

Convertit en chaîne décodée une chaîne encodée URL, à l'aide de l'objet d'encodage spécifié.Converts a URL-encoded string into a decoded string, using the specified encoding object.

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

Convertit un tableau d'octets encodé URL en tableau d'octets décodé.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)

Convertit un tableau d'octets encodé URL en tableau d'octets décodé, en commençant à l'emplacement spécifié dans le tableau et en continuant pour le nombre d'octets spécifié.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)

Convertit une chaîne encodée URL en tableau d'octets décodé.Converts a URL-encoded string into a decoded array of bytes.

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

Convertit une chaîne encodée URL en tableau d'octets décodé, à l'aide de l'objet de décodage spécifié.Converts a URL-encoded string into a decoded array of bytes using the specified decoding object.

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

Convertit un tableau d'octets en une chaîne d'URL encodée.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)

Convertit un tableau d'octets en chaîne encodé URL, en commençant à l'emplacement spécifié dans le tableau et en continuant pour le nombre d'octets spécifié.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)

Code une chaîne d'URL.Encodes a URL string.

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

Code une chaîne d'URL à l'aide de l'objet d'encodage spécifié.Encodes a URL string using the specified encoding object.

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

Convertit un tableau d'octets en tableau d'octets encodé URL.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)

Convertit un tableau d'octets en tableau d'octets encodé URL, en commençant à l'emplacement spécifié dans le tableau et en continuant pour le nombre d'octets spécifié.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)

Convertit une chaîne en tableau d'octets encodé URL.Converts a string into a URL-encoded array of bytes.

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

Convertit une chaîne en tableau d'octets encodé URL, à l'aide de l'objet d'encodage spécifié.Converts a string into a URL-encoded array of bytes using the specified encoding object.

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

Convertit une chaîne en chaîne Unicode.Converts a string into a Unicode string.

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

Convertit une chaîne Unicode en tableau d'octets.Converts a Unicode string into an array of bytes.

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

À ne pas utiliser ; conçu uniquement pour la compatibilité avec le navigateur.Do not use; intended only for browser compatibility. Utilisez UrlEncode(String).Use UrlEncode(String).

S’applique à

Voir aussi