ServiceCollection<T> Class

Article
02/04/2013

Represents a collection of services.

Inheritance Hierarchy

System.Object
System.Collections.Generic.Dictionary<Type, T>
Microsoft.VisualStudio.Shell.ServiceCollection<T>

Namespace: Microsoft.VisualStudio.Shell
Assembly: Microsoft.VisualStudio.Shell.10.0 (in Microsoft.VisualStudio.Shell.10.0.dll)

Syntax

'Declaration
Public Class ServiceCollection(Of T) _
    Inherits Dictionary(Of Type, T)

public class ServiceCollection<T> : Dictionary<Type, T>

generic<typename T>
public ref class ServiceCollection : public Dictionary<Type^, T>

type ServiceCollection<'T> =  
    class
        inherit Dictionary<Type, 'T>
    end

JScript does not support generic types or methods.

Type Parameters

T
The type of the collection.

The ServiceCollection<T> type exposes the following members.

Constructors

	Name	Description
	ServiceCollection<T>	Initializes a new instance of T[:Microsoft.VisualStudio.Shell.ServiceCollection`1.]

Top

Properties

	Name	Description
	Comparer	Gets the IEqualityComparer<T> that is used to determine equality of keys for the dictionary. (Inherited from Dictionary<Type, T>.)
	Count	Gets the number of key/value pairs contained in the Dictionary<TKey, TValue>. (Inherited from Dictionary<Type, T>.)
	Item	Gets or sets the value associated with the specified key. (Inherited from Dictionary<Type, T>.)
	Keys	Gets a collection containing the keys in the Dictionary<TKey, TValue>. (Inherited from Dictionary<Type, T>.)
	Values	Gets a collection containing the values in the Dictionary<TKey, TValue>. (Inherited from Dictionary<Type, T>.)

Top

Methods

	Name	Description
	Add	Adds the specified key and value to the dictionary. (Inherited from Dictionary<Type, T>.)
	Clear	Removes all keys and values from the Dictionary<TKey, TValue>. (Inherited from Dictionary<Type, T>.)
	ContainsKey	Determines whether the Dictionary<TKey, TValue> contains the specified key. (Inherited from Dictionary<Type, T>.)
	ContainsValue	Determines whether the Dictionary<TKey, TValue> contains a specific value. (Inherited from Dictionary<Type, T>.)
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetEnumerator	Returns an enumerator that iterates through the Dictionary<TKey, TValue>. (Inherited from Dictionary<Type, T>.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetObjectData	Implements the System.Runtime.Serialization.ISerializable interface and returns the data needed to serialize the Dictionary<TKey, TValue> instance. (Inherited from Dictionary<Type, T>.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	OnDeserialization	Implements the System.Runtime.Serialization.ISerializable interface and raises the deserialization event when the deserialization is complete. (Inherited from Dictionary<Type, T>.)
	Remove	Removes the value with the specified key from the Dictionary<TKey, TValue>. (Inherited from Dictionary<Type, T>.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	TryGetValue	Gets the value associated with the specified key. (Inherited from Dictionary<Type, T>.)

Top

Explicit Interface Implementations

	Name	Description
	ICollection<KeyValuePair<TKey, TValue>>.Add	Adds the specified value to the ICollection<T> with the specified key. (Inherited from Dictionary<Type, T>.)
	IDictionary.Add	Adds the specified key and value to the dictionary. (Inherited from Dictionary<Type, T>.)
	ICollection<KeyValuePair<TKey, TValue>>.Contains	Determines whether the ICollection<T> contains a specific key and value. (Inherited from Dictionary<Type, T>.)
	IDictionary.Contains	Determines whether the IDictionary contains an element with the specified key. (Inherited from Dictionary<Type, T>.)
	ICollection<KeyValuePair<TKey, TValue>>.CopyTo	Copies the elements of the ICollection<T> to an array of type KeyValuePair<TKey, TValue>, starting at the specified array index. (Inherited from Dictionary<Type, T>.)
	ICollection.CopyTo	Copies the elements of the ICollection<T> to an array, starting at the specified array index. (Inherited from Dictionary<Type, T>.)
	IEnumerable<KeyValuePair<TKey, TValue>>.GetEnumerator	Returns an enumerator that iterates through the collection. (Inherited from Dictionary<Type, T>.)
	IEnumerable.GetEnumerator	Returns an enumerator that iterates through the collection. (Inherited from Dictionary<Type, T>.)
	IDictionary.GetEnumerator	Returns an IDictionaryEnumerator for the IDictionary. (Inherited from Dictionary<Type, T>.)
	IDictionary.IsFixedSize	Gets a value indicating whether the IDictionary has a fixed size. (Inherited from Dictionary<Type, T>.)
	ICollection<KeyValuePair<TKey, TValue>>.IsReadOnly	Gets a value indicating whether the dictionary is read-only. (Inherited from Dictionary<Type, T>.)
	IDictionary.IsReadOnly	Gets a value indicating whether the IDictionary is read-only. (Inherited from Dictionary<Type, T>.)
	ICollection.IsSynchronized	Gets a value indicating whether access to the ICollection is synchronized (thread safe). (Inherited from Dictionary<Type, T>.)
	IDictionary.Item	Gets or sets the value with the specified key. (Inherited from Dictionary<Type, T>.)
	IDictionary<TKey, TValue>.Keys	Gets an ICollection<T> containing the keys of the IDictionary<TKey, TValue>. (Inherited from Dictionary<Type, T>.)
	IDictionary.Keys	Gets an ICollection containing the keys of the IDictionary. (Inherited from Dictionary<Type, T>.)
	ICollection<KeyValuePair<TKey, TValue>>.Remove	Removes a key and value from the dictionary. (Inherited from Dictionary<Type, T>.)
	IDictionary.Remove	Removes the element with the specified key from the IDictionary. (Inherited from Dictionary<Type, T>.)
	ICollection.SyncRoot	Gets an object that can be used to synchronize access to the ICollection. (Inherited from Dictionary<Type, T>.)
	IDictionary<TKey, TValue>.Values	Gets an ICollection<T> containing the values in the IDictionary<TKey, TValue>. (Inherited from Dictionary<Type, T>.)
	IDictionary.Values	Gets an ICollection containing the values in the IDictionary. (Inherited from Dictionary<Type, T>.)

Top

Remarks

Use this collection to store the mapping from the type of a service to the object that provides it in a way that is aware of embedded types. The comparer for this collection performs a comparison of the GUID properties of the Type key instead of doing a reference comparison, which will fail in type-embedding scenarios.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.