Sealed class: RT.Servers.NameValuesCollection<TValue>

• Assembly: RT.Servers, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null
• Namespace: RT.Servers
• Show inherited types...
  Inherits from:

  • object
• Show implemented interfaces...
  Implements:

  • System.Collections.Generic.ICollection<System.Collections.Generic.KeyValuePair<string, RT.Servers.ValuesCollection<TValue>>> (directly)
  • System.Collections.Generic.IDictionary<string, RT.Servers.ValuesCollection<TValue>> (directly)
  • System.Collections.IEnumerable (directly)
  • System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string, RT.Servers.ValuesCollection<TValue>>> (directly)

Summary

Encapsulates a collection that maps keys to collections of values. Provides the ability to cheaply make the collection fully read-only. Provides a sort of auto-vivification for convenience.

Generic type parameters

TValue

The type of the values to be associated with each key.

Example

// initially myNameValue does not contain the key "fruits"
int c = myNameValues["fruits"].Count;  // c == 0
myNameValues["fruits"].Add("orange");
// myNameValue now contains the key "fruits", with one value associated.

Constructors

NameValuesCollection<TValue>()	Creates an empty collection.
NameValuesCollection<TValue>(int capacity)	Creates an empty collection.

Instance methods

void	Add(KeyValuePair<string, ValuesCollection<TValue>> item) Implements: ICollection<KeyValuePair<string, ValuesCollection<TValue>>>.Add(KeyValuePair<string, ValuesCollection<TValue>>)	Adds the specified key and value collection.
void	Add(string key, ValuesCollection<TValue> value) Implements: IDictionary<string, ValuesCollection<TValue>>.Add(string, ValuesCollection<TValue>)	Adds all items from the specified value collection, associating them with the specified key. Throws an exception if the specified key already has items associated with it.
NameValuesCollection<TValue>	AsReadOnly()	Returns a read-only version of this collection. The returned collection could be the same as this one, if it's already read-only, or it could be a wrapper created around the items in this collection. If the original collection gets modified, the read-only version will reflect the changes instantly.
void	Clear() Implements: ICollection<KeyValuePair<string, ValuesCollection<TValue>>>.Clear()	Clears all items from this collection.
bool	Contains(KeyValuePair<string, ValuesCollection<TValue>> item) Implements: ICollection<KeyValuePair<string, ValuesCollection<TValue>>>.Contains(KeyValuePair<string, ValuesCollection<TValue>>)	Not implemented.
bool	ContainsKey(string key) Implements: IDictionary<string, ValuesCollection<TValue>>.ContainsKey(string)	Returns true iff this collection has at least one value associated with the specified key.
void	CopyTo(KeyValuePair<string, ValuesCollection<TValue>>[] array, int arrayIndex) Implements: ICollection<KeyValuePair<string, ValuesCollection<TValue>>>.CopyTo(KeyValuePair<string, ValuesCollection<TValue>>[], int)	Copies all key/value-collection pairs to the specified array.
IEnumerator<KeyValuePair<string, ValuesCollection<TValue>>>	GetEnumerator() Implements: IEnumerable<KeyValuePair<string, ValuesCollection<TValue>>>.GetEnumerator()	Gets an enumerator to iterate over all key/value-collection pairs in this collection.
bool	Remove(string key) Implements: IDictionary<string, ValuesCollection<TValue>>.Remove(string)	Removes all items associated with the specified key. Returns true iff any items were removed.
bool	Remove(KeyValuePair<string, ValuesCollection<TValue>> item) Implements: ICollection<KeyValuePair<string, ValuesCollection<TValue>>>.Remove(KeyValuePair<string, ValuesCollection<TValue>>)	Not implemented.
bool	TryGetValue(string key, out ValuesCollection<TValue> value) Implements: IDictionary<string, ValuesCollection<TValue>>.TryGetValue(string, out ValuesCollection<TValue>)	Gets the collection of values associated with the specified key, or an empty collection if no such items exist. Returns true iff any items are associated with the key.

Instance properties

int	Count Implements: ICollection<KeyValuePair<string, ValuesCollection<TValue>>>.Count	Gets the number of keys in this collection which have at least one value associated with them.
bool	IsReadOnly Implements: ICollection<KeyValuePair<string, ValuesCollection<TValue>>>.IsReadOnly	Returns true iff this collection is read-only (cannot be modified).
ValuesCollection<TValue>	this[string key] Implements: IDictionary<string, ValuesCollection<TValue>>.this[string]	Gets or sets a collection of values associated with the specified key.
ICollection<string>	Keys Implements: IDictionary<string, ValuesCollection<TValue>>.Keys	Gets a collection of the keys that have at least one value associated with them. This method is not particularly cheap.
ICollection<ValuesCollection<TValue>>	Values Implements: IDictionary<string, ValuesCollection<TValue>>.Values	Gets the collection of all value collections. This method is not particularly cheap.