Table of Contents

Class QueryStringCollection

Namespace
Cuemon.Net
Assembly
Cuemon.Net.dll

Provides a collection of string values that is equivalent to a query string of an Uri. Implements the NameValueCollection

public class QueryStringCollection : NameValueCollection, ICollection, IDeserializationCallback, ISerializable, IReadOnlyCollection<KeyValuePair<string, string>>, IEnumerable<KeyValuePair<string, string>>, IEnumerable
Inheritance
QueryStringCollection
Implements
Inherited Members

Examples

QueryStringCollection provides creation, parsing, and manipulation of URI query string parameters, extending NameValueCollection with URL decoding support. This example creates an empty collection and adds "search", "page", and "sort" parameters, parses an existing query string ("?category=books&author=tolkien") with and without URL decoding, and iterates key-value pairs. It also demonstrates cloning the collection and modifying the clone independently to verify they are separate instances. Console output shows the query string representation, decoded values, keys, clone independence, and entry counts.

using System;
using System.Linq;
using Cuemon.Net;

namespace MyApp.Net
{
    public static class QueryStringCollectionExamples
    {
        public static void Demonstrate()
        {
            // Create an empty query string collection and add parameters.
            var qsc = new QueryStringCollection();
            qsc.Add("search", "dotnet");
            qsc.Add("page", "2");
            qsc.Add("sort", "name");
            Console.WriteLine("Query string: {0}", qsc); // search=dotnet&page=2&sort=name

            // Create from an existing URI query string.
            var fromUrl = new QueryStringCollection("?category=books&author=tolkien");
            Console.WriteLine("Parsed query: {0}", fromUrl); // category=books&author=tolkien

            // Create with URL decoding enabled.
            var encoded = new QueryStringCollection("q=hello%20world&lang=en", urlDecode: true);
            Console.WriteLine("Decoded 'q': {0}", encoded["q"]); // hello world

            // Iterate over key-value pairs.
            Console.WriteLine("Parameters:");
            foreach (var pair in fromUrl)
            {
                Console.WriteLine("  {0} = {1}", pair.Key, pair.Value);

            // Use AllKeys from the base NameValueCollection.
            Console.WriteLine("Keys: {0}", string.Join(", ", qsc.AllKeys));

            // Clone a QueryStringCollection.
            var clone = new QueryStringCollection(qsc);
            clone["page"] = "3";
            Console.WriteLine("Original page: {0}", qsc["page"]);  // 2
            Console.WriteLine("Cloned page:   {0}", clone["page"]); // 3

            // Count entries.
            Console.WriteLine("Count: {0}", qsc.Count);

}}}
}

Constructors

QueryStringCollection()

Initializes a new instance of the QueryStringCollection class.

public QueryStringCollection()

QueryStringCollection(QueryStringCollection)

Initializes a new instance of the QueryStringCollection class.

public QueryStringCollection(QueryStringCollection qsc)

Parameters

qsc QueryStringCollection

The QueryStringCollection to copy to the new QueryStringCollection instance.

QueryStringCollection(string, bool)

Initializes a new instance of the QueryStringCollection class.

public QueryStringCollection(string query, bool urlDecode = false)

Parameters

query string

The query string of an Uri.

urlDecode bool

Specify true to decode the query that has been encoded for transmission in a URL; otherwise, false.

Methods

GetEnumerator()

Returns an enumerator that iterates through the collection.

public IEnumerator<KeyValuePair<string, string>> GetEnumerator()

Returns

IEnumerator<KeyValuePair<string, string>>

An enumerator that can be used to iterate through the collection.

ToString()

Returns a string that represents this instance.

public override string ToString()

Returns

string

A string that represents this instance.

See Also

NameValueCollection
Edit this page