HttpUtility Classe

Définition

Espace de noms:: System.Web

Assembly:: System.Web.dll

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

Assembly:: netstandard.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 pour l’encodage et le décodage des URL lors du 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 classe HttpUtility est utilisée en interne par la classe HttpServerUtility, dont les méthodes et les propriétés sont exposées via l’objet intrinsèque ASP.NET Server. En outre, la HttpUtility classe contient des méthodes d’encodage et de décodage utilitaire qui ne sont pas accessibles à partir du Server.

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

Constructeurs

Nom	Description
HttpUtility()	Initialise une nouvelle instance de la classe HttpUtility.

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
HtmlAttributeEncode(String, TextWriter)	Convertit au minimum une chaîne en chaîne encodée HTML et envoie la chaîne encodée à un TextWriter flux de sortie.
HtmlAttributeEncode(String)	Convertit au minimum une chaîne en chaîne encodée HTML.
HtmlDecode(String, TextWriter)	Convertit une chaîne codée au format HTML en chaîne décodée et envoie la chaîne décodée à un TextWriter flux de sortie.
HtmlDecode(String)	Convertit une chaîne codée au format HTML pour la transmission HTTP en chaîne décodée.
HtmlEncode(Object)	Convertit la représentation sous forme de chaîne d’un objet en chaîne encodée HTML et retourne la chaîne encodée.
HtmlEncode(String, TextWriter)	Convertit une chaîne en chaîne encodée HTML et retourne la sortie en tant que TextWriter flux de sortie.
HtmlEncode(String)	Convertit une chaîne en chaîne codée HTML.
JavaScriptStringEncode(String, Boolean)	Encode une chaîne.
JavaScriptStringEncode(String)	Encode une chaîne.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ParseQueryString(String, Encoding)	Analyse une chaîne de requête dans une NameValueCollection utilisation de l’objet spécifié Encoding.
ParseQueryString(String)	Analyse une chaîne de requête dans un NameValueCollection encodage à l’aide UTF8 .
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
UrlDecode(Byte[], Encoding)	Convertit un tableau d’octets encodé d’URL en 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é d’URL en chaîne décodée à l’aide de l’objet d’encodage spécifié, en commençant à la position spécifiée dans le tableau et en continuant pour le nombre d’octets spécifié.
UrlDecode(String, Encoding)	Convertit une chaîne encodée d’URL en chaîne décodée à l’aide de l’objet d’encodage spécifié.
UrlDecode(String)	Convertit une chaîne qui a été encodée pour la transmission dans une URL en chaîne décodée.
UrlDecodeToBytes(Byte[], Int32, Int32)	Convertit un tableau encodé d’octets en URL en 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(Byte[])	Convertit un tableau encodé d’octets en URL en tableau décodé d’octets.
UrlDecodeToBytes(String, Encoding)	Convertit une chaîne encodée d’URL en tableau décodé d’octets à l’aide de l’objet de décodage spécifié.
UrlDecodeToBytes(String)	Convertit une chaîne encodée d’URL en tableau décodé d’octets.
UrlEncode(Byte[], Int32, Int32)	Convertit un tableau d’octets en chaîne encodée PAR URL, en commençant à la position spécifiée dans le tableau et en continuant pour le nombre d’octets spécifié.
UrlEncode(Byte[])	Convertit un tableau d’octets en chaîne d’URL encodée.
UrlEncode(String, Encoding)	Encode une chaîne d’URL à l’aide de l’objet d’encodage spécifié.
UrlEncode(String)	Encode une chaîne d’URL.
UrlEncodeToBytes(Byte[], Int32, Int32)	Convertit un tableau d’octets en tableau codé en URL d’octets, en commençant à la position spécifiée dans le tableau et en continuant pour le nombre d’octets spécifié.
UrlEncodeToBytes(Byte[])	Convertit un tableau d’octets en tableau codé en URL d’octets.
UrlEncodeToBytes(String, Encoding)	Convertit une chaîne en tableau codé en URL d’octets à l’aide de l’objet d’encodage spécifié.
UrlEncodeToBytes(String)	Convertit une chaîne en tableau codé en URL d’octets.
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)	N’utilisez pas ; destiné uniquement à la compatibilité du navigateur. Utilisez UrlEncode(String).

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?