HttpUtility Classe

Référence

Définition

Espace de noms:: System.Web

Assembly:: System.Web.HttpUtility.dll

Assembly:: System.Web.dll

Assemblys:: System.Web.dll, System.Web.Services.dll

Assembly:: netstandard.dll

Assembly:: System.Web.Services.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit des méthodes de codage et décodage d'URL pendant le traitement des requêtes web. Cette classe ne peut pas être héritée.

public ref class HttpUtility sealed

public sealed class HttpUtility

type HttpUtility = class

Public NotInheritable Class HttpUtility

Héritage: Object
HttpUtility

Exemples

L’exemple de code suivant illustre l’utilisation des méthodes et ParseQueryString des UrlEncode UrlDecode méthodes de la HttpUtility classe.

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

La HttpUtility classe est utilisée en interne par la HttpServerUtility classe, dont les méthodes et les propriétés sont exposées par le biais de l’objet ASP.NET Server intrinsèque. En outre, la HttpUtility classe contient des méthodes utilitaires d’encodage et de décodage qui ne sont pas accessibles à partir du Server.

Pour coder ou décoder les valeurs en dehors d’une application web, utilisez la classe WebUtility.

Constructeurs

HttpUtility()

Initialise une nouvelle instance de la classe HttpUtility.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
HtmlAttributeEncode(String)	Effectue une conversion minimale d’une chaîne en une chaîne encodée au format HTML.
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.
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.
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 .
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.
HtmlEncode(String)	Convertit une chaîne en une chaîne encodée au format HTML.
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.
JavaScriptStringEncode(String)	Encode une chaîne.
JavaScriptStringEncode(String, Boolean)	Encode une chaîne.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ParseQueryString(String)	Analyse une chaîne de requête dans un NameValueCollection à l’aide de l’encodage UTF8.
ParseQueryString(String, Encoding)	Analyse une chaîne de requête dans un NameValueCollection à l’aide du Encoding spécifié.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
UrlDecode(Byte[], Encoding)	Convertit un tableau d’octets encodé en URL en une chaîne décodée à l’aide de l’objet de décodage spécifié.
UrlDecode(Byte[], Int32, Int32, Encoding)	Convertit un tableau d’octets encodé URL en une chaîne décodée à l’aide de l’objet de décodage spécifié, en commençant à la position spécifiée dans le tableau et en continuant pour le nombre spécifié d’octets.
UrlDecode(String)	Convertit une chaîne qui a été encodée en vue d’une transmission dans une URL en chaîne décodée.
UrlDecode(String, Encoding)	Convertit une chaîne encodée en URL en chaîne décodée, à l’aide de l’objet d’encodage spécifié.
UrlDecodeToBytes(Byte[])	Convertit un tableau d’octets encodé en URL en tableau d’octets décodé.
UrlDecodeToBytes(Byte[], Int32, Int32)	Convertit un tableau d’octets en chaîne encodée en URL en un tableau décodé d’octets, en commençant à la position spécifiée dans le tableau et en continuant pour le nombre spécifié d’octets.
UrlDecodeToBytes(String)	Convertit une chaîne encodée en URL en tableau d’octets décodé.
UrlDecodeToBytes(String, Encoding)	Convertit une chaîne codée URL en tableau d’octets décodé à l’aide de l’objet de décodage spécifié.
UrlEncode(Byte[])	Convertit un tableau d’octets en une chaîne d’URL encodée.
UrlEncode(Byte[], Int32, Int32)	Convertit un tableau d’octets en chaîne encodée en URL, en commençant à la position spécifiée dans le tableau et en continuant pour le nombre spécifié d’octets.
UrlEncode(String)	Encode une chaîne d’URL.
UrlEncode(String, Encoding)	Encode une chaîne d’URL à l’aide de l’objet de codage spécifié.
UrlEncodeToBytes(Byte[])	Convertit un tableau d’octets en un tableau d’octets encodé en URL.
UrlEncodeToBytes(Byte[], Int32, Int32)	Convertit un tableau d’octets en tableau d’octets encodé en URL, en commençant à la position spécifiée dans le tableau et en continuant pour le nombre spécifié d’octets.
UrlEncodeToBytes(String)	Convertit une chaîne en un tableau d’octets encodé en URL.
UrlEncodeToBytes(String, Encoding)	Convertit une chaîne en tableau encodé URL d’octets à l’aide de l’objet d’encodage spécifié.
UrlEncodeUnicode(String)	Obsolète. Convertit une chaîne en chaîne Unicode.
UrlEncodeUnicodeToBytes(String)	Obsolète. Convertit une chaîne Unicode en tableau d’octets.
UrlPathEncode(String)	À ne pas utiliser ; conçu uniquement pour la compatibilité avec le navigateur. Utilisez UrlEncode(String).

S’applique à