NameValueCollection

（转自 http://www.studyofnet.com/news/623.html）

NameValueCollection类集合是基于 NameObjectCollectionBase 类，但与 NameObjectCollectionBase 不同，

该类在一个键下存储多个字符串值（就是键相同，值就连接起来），每个元素都是一个键/值对。

NameValueCollection类的命名空间为：using System.Collections.Specialized。

NameValueCollection中当存在一个key的时候，你在add的话，会追加进当前key中，而不是简单替换。

例如

 

C# 代码   复制

 NameValueCollection myCol = new NameValueCollection();  
 myCol.Add("red", "rojo");//如果键值red相同结果合并 rojo,rouge  
 myCol.Add("green", "verde");  
 myCol.Add("blue", "azul");  
 myCol.Add("red", "rouge");  

一、NameValueCollection属性

AllKeys	该属性可以获取NameValueCollection 中的所有键。返回一个字符串数组。
Count	该属性获取NameValueCollection包含键值对的数目，返回一个int。
Item	该属性表明NameValueCollection可以通过索引访问，如nvc[1],nvc["key"].
Keys	该属性获取 NameObjectCollectionBase.KeysCollection 实例，该实例包含 NameObjectCollectionBase 实例中的所有键。
IsReadOnly	获取或设置一个值，通过该值指示 NameObjectCollectionBase 实例是否为只读的。

二、NameValueCollection方法 

Add	将项添加到当前 NameValueCollection。例如:一个参数是将一个NameValueCollection复制到当前NameValueCollection，两个就是一个键值对。
Clear	使缓存数组无效,并清空NameValueCollection。
CopyTo	从目标数组的指定索引处开始将整个 NameValueCollection 复制到兼容的一维 Array。
Get	获取 NameValueCollection 中指定项的值，可以通过key或索引号访问。
GetEnumerator	返回循环访问 NameObjectCollectionBase 的枚举数。
GetKey	获取 NameValueCollection 的指定索引处的键。
GetValues	获取 NameValueCollection 中指定项的值。返回一个字符串数组，为什么要返回一个数组呢？因为一个值里面可能会包括多个项。
HasKeys	获取一个值，该值指示 NameValueCollection 是否包含非空引用的键。即有键值对且键不为null就返回true，否则返回false。可用于判断对象是否为空。
Remove	移除 NameObjectCollectionBase 实例中具有指定键的项。只能够根据键key移除项，不能用索引移除。
Set	根据键值对重新设置一个项目。
OnDeserialization	实现 ISerializable 接口，并在完成反序列化之后引发反序列化事件。

三、NameValueCollection获取URL参数

 

C# 代码   复制

        public static NameValueCollection ParseQueryString(string url)

        {
            NameValueCollection cPar = new NameValueCollection();
            url = url.StartsWith("?") ? url.Substring(1) : url;
            string[] pairs = url.Split(new char[] { '&' });
            int tmpIndex;
            foreach (string pair in pairs)
            {
                if (string.IsNullOrEmpty(pair))
                    continue;
                tmpIndex = pair.IndexOf('=');
                if (tmpIndex == -1)
                    continue;
                cPar.Add(pair.Substring(0, tmpIndex), pair.Substring(tmpIndex + 1));
            }
            return cPar;
        }

四、NameValueCollection使用示例

 

C# 代码   复制

using System;  using System.Collections;  

using System.Collections.Specialized;  

namespace SamplesNameValueCollection  

{  
    class Program  
    {  
  
        public static void Main()  
        {  
            //初始化NameValueCollection需引用using System.Collections.Specialized;  
            NameValueCollection myCol = new NameValueCollection();  
            myCol.Add("red", "rojo");//如果键值red相同结果合并 rojo,rouge  
            myCol.Add("green", "verde");  
            myCol.Add("blue", "azul");  
            myCol.Add("red", "rouge");  
  
            // Displays the values in the NameValueCollection in two different ways.  
            //显示键，值  
            Console.WriteLine("Displays the elements using the AllKeys property and the Item (indexer) property:");  
            PrintKeysAndValues(myCol);  
            Console.WriteLine("Displays the elements using GetKey and Get:");  
            PrintKeysAndValues2(myCol);  
  
            // Gets a value either by index or by key.  
            //按索引或值获取  
            Console.WriteLine("Index 1 contains the value {0}.", myCol[1]);//索引1的值  
            Console.WriteLine("Key /"red/" has the value {0}.", myCol["red"]);//键为red的对应值rouge  
            Console.WriteLine();  
  
            // Copies the values to a string array and displays the string array.  
            String[] myStrArr = new String[myCol.Count];  
            myCol.CopyTo(myStrArr, 0);  
            Console.WriteLine("The string array contains:");  
            foreach (String s in myStrArr)  
                Console.WriteLine("   {0}", s);  
            Console.WriteLine();  
  
            //查找green键值然后删除  
            myCol.Remove("green");  
            Console.WriteLine("The collection contains the following elements after removing /"green/":");  
            PrintKeysAndValues(myCol);  
  
            //清空集合  
            myCol.Clear();  
            Console.WriteLine("The collection contains the following elements after it is cleared:");  
            PrintKeysAndValues(myCol);  
  
        }  
        //显示键，值  
        public static void PrintKeysAndValues(NameValueCollection myCol)  
        {  
            IEnumerator myEnumerator = myCol.GetEnumerator();  
            Console.WriteLine("   KEY        VALUE");  
            foreach (String s in myCol.AllKeys)  
                Console.WriteLine("   {0,-10} {1}", s, myCol[s]);  
            Console.WriteLine();  
        }  
        //显示索引, 键,值  
        public static void PrintKeysAndValues2(NameValueCollection myCol)  
        {  
            Console.WriteLine("   [INDEX] KEY        VALUE");  
            for (int i = 0; i < myCol.Count; i++)  
                Console.WriteLine("   [{0}]     {1,-10} {2}", i, myCol.GetKey(i), myCol.Get(i));  
            Console.WriteLine();  
        }  
    }  
  
}  

五、NameValueCollection与Hashtable的区别

NameValueCollection 键允许重复.

HashTable 是键-值集合,但键不能出现重复.