HttpUtility.ParseQueryString Method

Definition

Namespace:

System.Web

Assemblies:

netstandard.dll, System.Web.HttpUtility.dll

Parses a query string into a NameValueCollection.

Overloads

ParseQueryString(String)	Parses a query string into a NameValueCollection using UTF8 encoding.
ParseQueryString(String, Encoding)	Parses a query string into a NameValueCollection using the specified Encoding.

ParseQueryString(String)

Source:

HttpUtility.cs

Parses a query string into a NameValueCollection using UTF8 encoding.

C#

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

Parameters

query

String

The query string to parse.

Returns

NameValueCollection

A NameValueCollection of query parameters and values.

Exceptions

ArgumentNullException

query is null.

Examples

The following code example demonstrates how to use the ParseQueryString method. Multiple occurrences of the same query string variable are consolidated in one entry of the returned NameValueCollection.

C#

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

Remarks

The ParseQueryString method uses UTF8 format to parse the query string In the returned NameValueCollection, URL encoded characters are decoded and multiple occurrences of the same query string parameter are listed as a single entry with a comma separating each value.

Important

The ParseQueryString method uses query strings that might contain user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

See also

• Encoding

ParseQueryString(String, Encoding)

Source:

HttpUtility.cs

Parses a query string into a NameValueCollection using the specified Encoding.

C#

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

Parameters

query

String

The query string to parse.

encoding

Encoding

The Encoding to use.

Returns

NameValueCollection

A NameValueCollection of query parameters and values.

Exceptions

ArgumentNullException

query is null.

-or-

encoding is null.

Remarks

In the returned NameValueCollection, URL encoded characters are decoded and multiple occurrences of the same query string parameter are listed as a single entry with a comma separating each value.

Important

The ParseQueryString method uses query strings that might contain user input, which is a potential security threat. By default, ASP.NET Web pages validate that user input does not include script or HTML elements. For more information, see Script Exploits Overview.

See also

• Encoding