ComponentCollection Class
Provides a read-only container for a collection of IComponent objects.
System.Collections::ReadOnlyCollectionBase
System.ComponentModel::ComponentCollection
Assembly: System (in System.dll)
The ComponentCollection type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | ComponentCollection | Initializes a new instance of the ComponentCollection class using the specified array of components. |
| Name | Description | |
|---|---|---|
![]() | Count | Gets the number of elements contained in the ReadOnlyCollectionBase instance. (Inherited from ReadOnlyCollectionBase.) |
![]() | InnerList | Gets the list of elements contained in the ReadOnlyCollectionBase instance. (Inherited from ReadOnlyCollectionBase.) |
![]() | Item[Int32] | Gets the Component in the collection at the specified collection index. |
![]() | Item[String] | Gets any component in the collection matching the specified name. |
| Name | Description | |
|---|---|---|
![]() | CopyTo | Copies the entire collection to an array, starting writing at the specified array index. |
![]() | Equals(Object) | 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 ReadOnlyCollectionBase instance. (Inherited from ReadOnlyCollectionBase.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Name | Description | |
|---|---|---|
![]() ![]() | ICollection::CopyTo | Copies the entire ReadOnlyCollectionBase to a compatible one-dimensional Array, starting at the specified index of the target array. (Inherited from ReadOnlyCollectionBase.) |
![]() ![]() | ICollection::IsSynchronized | Gets a value indicating whether access to a ReadOnlyCollectionBase object is synchronized (thread safe). (Inherited from ReadOnlyCollectionBase.) |
![]() ![]() | ICollection::SyncRoot | Gets an object that can be used to synchronize access to a ReadOnlyCollectionBase object. (Inherited from ReadOnlyCollectionBase.) |
This collection inherits from ReadOnlyCollectionBase. The only way to add IComponent objects to this collection is to use the class constructor.
This collection provides two indexer properties, a string indexer and an integer indexer. The string indexer property returns a component in the collection by name if the Site property of a component in the collection is not nullptr and the Name property of the Site property of the component matches the specified string. The integer indexer property returns the IComponent at the specified collection index. The CopyTo method copies the contents of the collection to a specified array, beginning writing to the array at the specified index.
Note |
|---|
The HostProtectionAttribute attribute applied to this type or member has the following Resources property value: Synchronization. The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes. |
The following code example demonstrates how to use a ComponentCollection to enumerate a collection of custom BookComponent objects.
//This code segment implements the IContainer interface. The code segment //containing the implementation of ISite and IComponent can be found in the documentation //for those interfaces. //Implement the LibraryContainer using the IContainer interface. ref class LibraryContainer: public IContainer { private: ArrayList^ m_bookList; public: LibraryContainer() { m_bookList = gcnew ArrayList; } virtual void Add( IComponent^ book ) { //The book will be added without creation of the ISite object. m_bookList->Add( book ); } virtual void Add( IComponent^ book, String^ ISNDNNum ) { for ( int i = 0; i < m_bookList->Count; ++i ) { IComponent^ curObj = static_cast<IComponent^>(m_bookList->default[ i ]); if ( curObj->Site != nullptr ) { if ( curObj->Site->Name->Equals( ISNDNNum ) ) throw gcnew SystemException( "The ISBN number already exists in the container" ); } } ISBNSite^ data = gcnew ISBNSite( this,book ); data->Name = ISNDNNum; book->Site = data; m_bookList->Add( book ); } virtual void Remove( IComponent^ book ) { for ( int i = 0; i < m_bookList->Count; ++i ) { if ( book->Equals( m_bookList->default[ i ] ) ) { m_bookList->RemoveAt( i ); break; } } } property ComponentCollection^ Components { virtual ComponentCollection^ get() { array<IComponent^>^datalist = gcnew array<BookComponent^>(m_bookList->Count); m_bookList->CopyTo( datalist ); return gcnew ComponentCollection( datalist ); } } ~LibraryContainer() { for ( int i = 0; i < m_bookList->Count; ++i ) { IComponent^ curObj = static_cast<IComponent^>(m_bookList->default[ i ]); delete curObj; } m_bookList->Clear(); } }; [STAThreadAttribute] int main() { LibraryContainer^ cntrExmpl = gcnew LibraryContainer; try { BookComponent^ book1 = gcnew BookComponent( "Wizard's First Rule","Terry Gooodkind" ); cntrExmpl->Add( book1, "0812548051" ); BookComponent^ book2 = gcnew BookComponent( "Stone of Tears","Terry Gooodkind" ); cntrExmpl->Add( book2, "0812548094" ); BookComponent^ book3 = gcnew BookComponent( "Blood of the Fold","Terry Gooodkind" ); cntrExmpl->Add( book3, "0812551478" ); BookComponent^ book4 = gcnew BookComponent( "The Soul of the Fire","Terry Gooodkind" ); //This will generate exception because the ISBN already exists in the container. cntrExmpl->Add( book4, "0812551478" ); } catch ( SystemException^ e ) { Console::WriteLine( "Error description: {0}", e->Message ); } ComponentCollection^ datalist = cntrExmpl->Components; IEnumerator^ denum = datalist->GetEnumerator(); while ( denum->MoveNext() ) { BookComponent^ cmp = static_cast<BookComponent^>(denum->Current); Console::WriteLine( "Book Title: {0}", cmp->Title ); Console::WriteLine( "Book Author: {0}", cmp->Author ); Console::WriteLine( "Book ISBN: {0}", cmp->Site->Name ); } return 0; }
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

