GlobalObjectCollection Class

Article
02/04/2013

A strongly typed collection of global objects. The collection can be read-write or read-only. A read-write collection can be cheaply passed to the constructor of GlobalObjectCollection to make a read only version without copying the collection.

Inheritance Hierarchy

System.Object
System.MarshalByRefObject
Microsoft.VisualStudio.Shell.Design.GlobalObjectCollection

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

Syntax

'Declaration
Public NotInheritable Class GlobalObjectCollection _
    Inherits MarshalByRefObject _
    Implements IList, ICollection, IEnumerable

public sealed class GlobalObjectCollection : MarshalByRefObject, 
    IList, ICollection, IEnumerable

public ref class GlobalObjectCollection sealed : public MarshalByRefObject, 
    IList, ICollection, IEnumerable

[<Sealed>]
type GlobalObjectCollection =  
    class
        inherit MarshalByRefObject
        interface IList
        interface ICollection
        interface IEnumerable
    end

public final class GlobalObjectCollection extends MarshalByRefObject implements IList, ICollection, IEnumerable

The GlobalObjectCollection type exposes the following members.

Constructors

	Name	Description
	GlobalObjectCollection()	Initializes a new instance of a strongly-typed collection of global objects.
	GlobalObjectCollection(array<GlobalObject[])	Initializes a new instance of a strongly-typed collection of global objects initially populated by an array of global objects.
	GlobalObjectCollection(GlobalObjectCollection)	Initializes a new instance of a strongly-typed collection of global objects initially populated by the array items.
	GlobalObjectCollection(array<GlobalObject[], Boolean)	Initializes a new instance of a strongly-typed collection of global objects initially populated by an array of global objects.
	GlobalObjectCollection(GlobalObjectCollection, Boolean)	Initializes a new instance of global objects for the specified global object collection for the specified read/write access.

Top

Properties

	Name	Description
	Count	Returns the number of items in this collection.
	IsFixedSize	Determines whether this collection's size can be changed.
	IsReadOnly	Determines whether this collection is read-only.
	IsSynchronized	Determines whether this collection is synchronized for multi-threaded access.
	Item	Gets or sets the item at the given index.
	SyncRoot	Gets the object on which to synchronize access.

Top

Methods

	Name	Description
	Add	Adds a new item to the collection.
	AddRange(array<GlobalObject[])	Appends the objects in an array to the end of the collection.
	AddRange(GlobalObjectCollection)	Appends the objects in an array to the end of the collection.
	Clear	Clears the contents of this collection.
	Contains	Determines whether this collection contains the given item.
	CopyTo	Copies the contents of this collection to the given array starting at the given index.
	CreateObjRef	Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.)
	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 for this collection.
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetLifetimeService	Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	IndexOf	Gets the position of an object in the collection.
	InitializeLifetimeService	Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
	Insert	Inserts a new item into the collection at the given index.
	MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object.)
	MemberwiseClone(Boolean)	Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
	Remove	Removes an object from the collection.
	RemoveAt	Removes an object from the collection at the specified position.
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Explicit Interface Implementations

	Name	Description
	IList.Add	Adds an object to the collection.
	IList.Contains	Determines whether an object is in the collection.
	ICollection.CopyTo	Copies the contents of this collection to the given array starting at the given index.
	IList.IndexOf	Gets the position of an object in the collection.
	IList.Insert	Adds an item to the collection at the specified position.
	IList.Item	Gets or sets the global object at the specified index.
	IList.Remove	Removes an object from the collection.