Class NameValueCollectionExtensions

Namespace: Cuemon.Extensions.Net

Assembly: Cuemon.Extensions.Net.dll

Extension methods for the NameValueCollection class.

public static class NameValueCollectionExtensions

Inheritance: object

NameValueCollectionExtensions

Examples

NameValueCollectionExtensions in the Net namespace converts NameValueCollection instances into URL query strings with optional percent-encoding. This example populates a collection with "name": "John Doe", "city": "Copenhagen", and duplicate key "hobbies": ["reading", "coding"], then calls ToQueryString() to produce name=John Doe&city=Copenhagen&hobbies=reading&hobbies=coding and ToQueryString(urlEncode: true) where spaces become +. It also handles an empty collection that returns an empty string. Console output shows both query string variants and the empty result.

using System;
using System.Collections.Specialized;
using Cuemon.Extensions.Net;

namespace MyApp.Net
{
    public class NameValueCollectionExtensionsExample
    {
        public void Demonstrate()
        {
            var nvc = new NameValueCollection
            {
                { "name", "John Doe" },
                { "city", "Copenhagen" },
                { "hobbies", "reading" },
                { "hobbies", "coding" }
            };

            // Convert NameValueCollection to a query string (not URL-encoded)
            string queryString = nvc.ToQueryString();
            Console.WriteLine(queryString);
            // Output: name=John Doe&city=Copenhagen&hobbies=reading&hobbies=coding

            // URL-encode the values for safe HTTP transmission
            string encoded = nvc.ToQueryString(urlEncode: true);
            Console.WriteLine(encoded);
            // Output: name=John+Doe&city=Copenhagen&hobbies=reading&hobbies=coding

            // Empty collection
            var empty = new NameValueCollection();
            string emptyResult = empty.ToQueryString();
            Console.WriteLine($"Empty: '{emptyResult}'"); // Empty: ''

}}
}

Methods

ToQueryString(NameValueCollection, bool)

Converts the specified nvc into its string equivalent.

public static string ToQueryString(this NameValueCollection nvc, bool urlEncode = false)

Parameters

nvc NameValueCollection: The NameValueCollection to extend.
urlEncode bool: Specify true to encode the nvc into a URL-encoded string; otherwise, false. Default is false.

Returns