Lire en anglais

Partager via


HttpUtility.ParseQueryString Méthode

Définition

Analyse une chaîne de requête dans un NameValueCollection.

Surcharges

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é.

ParseQueryString(String)

Source:
HttpUtility.cs
Source:
HttpUtility.cs
Source:
HttpUtility.cs

Analyse une chaîne de requête dans un NameValueCollection à l’aide de l’encodage UTF8.

public static System.Collections.Specialized.NameValueCollection ParseQueryString (string query);

Paramètres

query
String

Chaîne de requête à analyser.

Retours

NameValueCollection des paramètres et valeurs de requête.

Exceptions

query a la valeur null.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode ParseQueryString. Plusieurs occurrences de la même variable de chaîne de requête sont consolidées dans une entrée du retourné NameValueCollection.


using System;
using System.Web;

class Program
{
    static void Main()
    {
        // Parse the URL and get the query string
        var url = "https://www.microsoft.com?name=John&age=30&location=USA";
        var parsedUrl = url.Split('?')[1];

        // The ParseQueryString method will parse the query string and return a NameValueCollection
        var paramsCollection = HttpUtility.ParseQueryString(parsedUrl);

        // The foreach loop will iterate over the params collection and print the key and value for each param
        foreach (var key in paramsCollection.AllKeys)
        {
            Console.WriteLine($"Key: {key} => Value: {paramsCollection[key]}");
        }
    }
}

// The example displays the following output:
// Key: name => Value: John
// Key: age => Value: 30
// Key: location => Value: USA

Remarques

La ParseQueryString méthode utilise UTF8 le format pour analyser la chaîne de requête Dans le retourné NameValueCollection, les caractères encodés d’URL sont décodés et plusieurs occurrences du même paramètre de chaîne de requête sont répertoriées en tant qu’entrée unique avec une virgule séparant chaque valeur.

Important

La ParseQueryString méthode utilise des chaînes de requête qui peuvent contenir une entrée utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ParseQueryString(String, Encoding)

Source:
HttpUtility.cs
Source:
HttpUtility.cs
Source:
HttpUtility.cs

Analyse une chaîne de requête dans un NameValueCollection à l’aide du Encoding spécifié.

public static System.Collections.Specialized.NameValueCollection ParseQueryString (string query, System.Text.Encoding encoding);

Paramètres

query
String

Chaîne de requête à analyser.

encoding
Encoding

Encoding à utiliser.

Retours

NameValueCollection des paramètres et valeurs de requête.

Exceptions

query a la valeur null.

-ou-

encoding a la valeur null.

Remarques

Dans le retourné NameValueCollection, les caractères encodés d’URL sont décodés et plusieurs occurrences du même paramètre de chaîne de requête sont répertoriées en tant qu’entrée unique avec une virgule séparant chaque valeur.

Important

La ParseQueryString méthode utilise des chaînes de requête qui peuvent contenir une entrée utilisateur, ce qui constitue une menace potentielle pour la sécurité. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques de script.

Voir aussi

S’applique à

.NET 9 et autres versions
Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1