HttpUtility.ParseQueryString Méthode

Définition

Espace de noms:

System.Web

Assembly:

System.Web.HttpUtility.dll

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

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

public:
 static System::Collections::Specialized::NameValueCollection ^ ParseQueryString(System::String ^ query);

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

static member ParseQueryString : string -> System.Collections.Specialized.NameValueCollection

Public Shared Function ParseQueryString (query As String) As NameValueCollection

Paramètres

query

String

Chaîne de requête à analyser.

Retours

NameValueCollection

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

Exceptions

ArgumentNullException

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

Imports System.Collections.Specialized
Imports System.Web

Public Class Sample
    Public Shared Sub Main()
        ' Parse the URL and get the query string
        Dim url As String = "https://www.microsoft.com?name=John&age=30&location=USA"
        Dim parsedUrl As String = url.Split("?")(1)

        ' The ParseQueryString method will parse the query string and return a NameValueCollection
        Dim paramsCollection As NameValueCollection = HttpUtility.ParseQueryString(parsedUrl)

        ' The For Each loop will iterate over the params collection and print the key and value for each param
        For Each key As String In paramsCollection.AllKeys
            Console.WriteLine($"Key: {key} => Value: {paramsCollection(key)}")
        Next
    End Sub
End Class

' 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

• Encoding

ParseQueryString(String, Encoding)

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(System::String ^ query, System::Text::Encoding ^ encoding);

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

static member ParseQueryString : string * System.Text.Encoding -> System.Collections.Specialized.NameValueCollection

Public Shared Function ParseQueryString (query As String, encoding As Encoding) As NameValueCollection

Paramètres

query

String

Chaîne de requête à analyser.

encoding

Encoding

Encoding à utiliser.

Retours

NameValueCollection

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

Exceptions

ArgumentNullException

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

• Encoding