Class DictionaryExtensions

Namespace

Cuemon.Extensions.Collections.Specialized

Assembly

Cuemon.Extensions.Collections.Specialized.dll

Extension methods for the IDictionary<TKey, TValue> interface.

public static class DictionaryExtensions

Inheritance

object

DictionaryExtensions

Examples

DictionaryExtensions in the Specialized namespace converts Dictionary<string, string[]> into NameValueCollection instances, joining multi-valued keys with a configurable delimiter. This example creates a dictionary with "colors": ["red", "green", "blue"] and "sizes": ["small", "large"], calls ToNameValueCollection() to produce a collection using the default comma delimiter, then calls ToNameValueCollection with a custom ";" delimiter via an options delegate. Console output confirms that "colors" becomes "red,green,blue" with the default delimiter and "red;green;blue" with the custom semicolon delimiter.

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

namespace MyApp.Extensions.Collections.Specialized
{
    public class DictionaryExtensionsExample
    {
        public void Demonstrate()
        {
            // Create a dictionary with string array values
            var source = new Dictionary<string, string[]>
            {
                ["colors"] = new[] { "red", "green", "blue" },
                ["sizes"] = new[] { "small", "large" }
            };

            // Convert to a NameValueCollection (default delimiter is comma)
            NameValueCollection nvc = source.ToNameValueCollection();

            Console.WriteLine(nvc["colors"]); // "red,green,blue"
            Console.WriteLine(nvc["sizes"]);  // "small,large"

            // Convert with a custom delimiter
            NameValueCollection nvcSemicolon = source.ToNameValueCollection(o =>
            {
                o.Delimiter = ";";
            });

            Console.WriteLine(nvcSemicolon["colors"]); // "red;green;blue"
            Console.WriteLine(nvcSemicolon["sizes"]);  // "small;large"

}}
}

Methods

ToNameValueCollection(IDictionary<string, string[]>, Action<DelimitedStringOptions<string>>)

Creates a NameValueCollection from the specified source.

public static NameValueCollection ToNameValueCollection(this IDictionary<string, string[]> source, Action<DelimitedStringOptions<string>> setup = null)

Parameters

source IDictionary<string, string[]>

An IDictionary<TKey, TValue> to extend.

setup Action<DelimitedStringOptions<string>>

The DelimitedStringOptions{string} which may be configured.

Returns

NameValueCollection

A NameValueCollection that is equivalent to the specified source.

Exceptions

ArgumentNullException

source cannot be null.