Interface IPropertyBag

Namespace

NUnit.Framework.Interfaces

Assembly

nunit.framework.dll

A PropertyBag represents a collection of name/value pairs that allows duplicate entries with the same key. Methods are provided for adding a new pair as well as for setting a key to a single value. All keys are strings but _values may be of any type. Null _values are not permitted, since a null entry represents the absence of the key.

The entries in a PropertyBag are of two kinds: those that take a single value and those that take multiple _values. However, the PropertyBag has no knowledge of which entries fall into each category and the distinction is entirely up to the code using the PropertyBag.

When working with multi-valued properties, client code should use the Add method to add name/value pairs and indexing to retrieve a list of all _values for a given key. For example:

bag.Add("Tag", "one");
bag.Add("Tag", "two");
Assert.That(bag["Tag"],
  Is.EqualTo(new string[] { "one", "two" })); 

When working with single-valued propeties, client code should use the Set method to set the value and Get to retrieve the value. The GetSetting methods may also be used to retrieve the value in a type-safe manner while also providing default. For example:

bag.Set("Priority", "low");
bag.Set("Priority", "high"); // replaces value
Assert.That(bag.Get("Priority"),
  Is.EqualTo("high"));
Assert.That(bag.GetSetting("Priority", "low"),
  Is.EqualTo("high"));

public interface IPropertyBag : IXmlNodeBuilder

Inherited Members

IXmlNodeBuilder.ToXml(bool)

IXmlNodeBuilder.AddToXml(TNode, bool)

Properties

this[string]

Gets or sets the list of _values for a particular key

IList this[string key] { get; set; }

Parameters

key string

The key for which the _values are to be retrieved or set

Property Value

IList

Keys

Gets a collection containing all the keys in the property set

ICollection<string> Keys { get; }

Property Value

ICollection<string>

Methods

Add(string, object)

Adds a key/value pair to the property bag

void Add(string key, object value)

Parameters

key string

The key

value object

The value

ContainsKey(string)

Gets a flag indicating whether the specified key has any entries in the property set.

bool ContainsKey(string key)

Parameters

key string

The key to be checked

Returns

bool

True if their are _values present, otherwise false

Get(string)

Gets a single value for a key, using the first one if multiple _values are present and returning null if the value is not found.

object Get(string key)

Parameters

key string

Returns

object

Set(string, object)

Sets the value for a key, removing any other _values that are already in the property set.

void Set(string key, object value)

Parameters

key string

value object