ComponentCollection クラス
アセンブリ: System (system.dll 内)


このコレクションは ReadOnlyCollectionBase から継承します。クラス コンストラクタを使用した場合だけに、このコレクションに IComponent オブジェクトを追加できます。
このコレクションは、文字列インデクサと整数インデクサの 2 つのインデクサ プロパティを提供します。文字列インデクサ プロパティは、コレクションに含まれるコンポーネントの Site プロパティが null 参照 (Visual Basic では Nothing) ではなく、コンポーネントの Site プロパティの Name プロパティが指定した文字列に一致する場合、名前によってコレクション内のコンポーネントを正しく返します。整数インデクサ プロパティは、指定したコレクション インデックスの IComponent を返します。CopyTo メソッドは、コレクションの内容を指定された配列にコピーします。配列への書き込みは指定されたインデックスから開始されます。
![]() |
---|
このクラスに適用される HostProtectionAttribute 属性の Resources プロパティの値は、Synchronization です。HostProtectionAttribute は、デスクトップ アプリケーション (一般的には、アイコンをダブルクリック、コマンドを入力、またはブラウザに URL を入力して起動するアプリケーション) には影響しません。詳細については、HostProtectionAttribute クラスのトピックまたは「SQL Server プログラミングとホスト保護属性」を参照してください。 |

ComponentCollection を使用して、カスタム BookComponent オブジェクトのコレクションを列挙する方法を次のコード例に示します。
'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. Class LibraryContainer Implements IContainer Private m_bookList As ArrayList Public Sub New() m_bookList = New ArrayList() End Sub Public Sub Add(ByVal book As IComponent) Implements IContainer.Add 'The book will be added without creation of the ISite object. m_bookList.Add(book) End Sub Public Sub Add(ByVal book As IComponent, ByVal ISNDNNum As String) Implements IContainer.Add Dim i As Integer Dim curObj As IComponent For i = 0 To m_bookList.Count - 1 curObj = CType(m_bookList(i), IComponent) If Not curObj.Site Is Nothing Then If (curObj.Site.Name.Equals(ISNDNNum)) Then Throw New SystemException("The ISBN number already exists in the container") End If End If Next i Dim data As ISBNSite = New ISBNSite(Me, book) data.Name = ISNDNNum book.Site = data m_bookList.Add(book) End Sub Public Sub Remove(ByVal book As IComponent) Implements IContainer.Remove Dim i As Integer Dim curComp As BookComponent = CType(book, BookComponent) For i = 0 To m_bookList.Count - 1 If (curComp.Equals(m_bookList(i)) = True) Then m_bookList.RemoveAt(i) Exit For End If Next i End Sub Public ReadOnly Property Components() As ComponentCollection Implements IContainer.Components Get Dim datalist(m_bookList.Count - 1) As IComponent m_bookList.CopyTo(datalist) Return New ComponentCollection(datalist) End Get End Property Public Overridable Sub Dispose() Implements IDisposable.Dispose Dim i As Integer For i = 0 To m_bookList.Count - 1 Dim curObj As IComponent = CType(m_bookList(i), IComponent) curObj.Dispose() Next i m_bookList.Clear() End Sub Public Shared Sub Main() Dim cntrExmpl As LibraryContainer = New LibraryContainer() Try Dim book1 As BookComponent = New BookComponent("Wizard's First Rule", "Terry Gooodkind") cntrExmpl.Add(book1, "0812548051") Dim book2 As BookComponent = New BookComponent("Stone of Tears", "Terry Gooodkind") cntrExmpl.Add(book2, "0812548094") Dim book3 As BookComponent = New BookComponent("Blood of the Fold", "Terry Gooodkind") cntrExmpl.Add(book3, "0812551478") Dim book4 As BookComponent = New BookComponent("The Soul of the Fire", "Terry Gooodkind") 'This will generate an exception, because the ISBN already exists in the container. cntrExmpl.Add(book4, "0812551478") Catch e As SystemException Console.WriteLine("Error description: " + e.Message) End Try Dim datalist As ComponentCollection = cntrExmpl.Components Dim denum As IEnumerator = datalist.GetEnumerator() While (denum.MoveNext()) Dim cmp As BookComponent = CType(denum.Current, BookComponent) Console.WriteLine("Book Title: " + cmp.Title) Console.WriteLine("Book Author: " + cmp.Author) Console.WriteLine("Book ISBN: " + cmp.Site.Name) End While End Sub End Class
//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. class LibraryContainer : IContainer { private ArrayList m_bookList; public LibraryContainer() { m_bookList = new ArrayList(); } public virtual void Add(IComponent book) { //The book will be added without creation of the ISite object. m_bookList.Add(book); } public virtual void Add(IComponent book, string ISNDNNum) { for(int i =0; i < m_bookList.Count; ++i) { IComponent curObj = (IComponent)m_bookList[i]; if(curObj.Site != null) { if(curObj.Site.Name.Equals(ISNDNNum)) throw new SystemException("The ISBN number already exists in the container"); } } ISBNSite data = new ISBNSite(this, book); data.Name = ISNDNNum; book.Site = data; m_bookList.Add(book); } public virtual void Remove(IComponent book) { for(int i =0; i < m_bookList.Count; ++i) { if(book.Equals(m_bookList[i])) { m_bookList.RemoveAt(i); break; } } } public ComponentCollection Components { get { IComponent[] datalist = new BookComponent[m_bookList.Count]; m_bookList.CopyTo(datalist); return new ComponentCollection(datalist); } } public virtual void Dispose() { for(int i =0; i < m_bookList.Count; ++i) { IComponent curObj = (IComponent)m_bookList[i]; curObj.Dispose(); } m_bookList.Clear(); } static void Main(string[] args) { LibraryContainer cntrExmpl = new LibraryContainer(); try { BookComponent book1 = new BookComponent("Wizard's First Rule", "Terry Gooodkind"); cntrExmpl.Add(book1, "0812548051"); BookComponent book2 = new BookComponent("Stone of Tears", "Terry Gooodkind"); cntrExmpl.Add(book2, "0812548094"); BookComponent book3 = new BookComponent("Blood of the Fold", "Terry Gooodkind"); cntrExmpl.Add(book3, "0812551478"); BookComponent book4 = new 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: " + e.Message); } ComponentCollection datalist =cntrExmpl.Components; IEnumerator denum = datalist.GetEnumerator(); while(denum.MoveNext()) { BookComponent cmp = (BookComponent)denum.Current; Console.WriteLine("Book Title: " + cmp.Title); Console.WriteLine("Book Author: " + cmp.Author); Console.WriteLine("Book ISBN: " + cmp.Site.Name); } } }
// 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. class LibraryContainer implements IContainer { private ArrayList mBookList; public LibraryContainer() { mBookList = new ArrayList(); } //LibraryContainer public void Add(IComponent book) { // The book will be added without creation of the ISite object. mBookList.Add(book); } //Add public void Add(IComponent book, String isndNNum) throws SystemException { for (int i = 0; i < mBookList.get_Count(); ++i) { IComponent curObj = (IComponent)mBookList.get_Item(i); if (curObj.get_Site() != null) { if (curObj.get_Site().get_Name().Equals(isndNNum)) { throw new SystemException( "The ISBN number already exists in the container"); } } } ISBNSite data = new ISBNSite(this, book); data.set_Name(isndNNum); book.set_Site(data); mBookList.Add(book); } //Add public void Remove(IComponent book) { for (int i = 0; i < mBookList.get_Count(); ++i) { if (book.Equals(mBookList.get_Item(i))) { mBookList.RemoveAt(i); break; } } } //Remove /** @property */ public ComponentCollection get_Components() { IComponent dataList[] = new BookComponent[mBookList.get_Count()]; mBookList.CopyTo(dataList); return new ComponentCollection(dataList); } //get_Components public void Dispose() { for (int i = 0; i < mBookList.get_Count(); ++i) { IComponent curObj = (IComponent)mBookList.get_Item(i); curObj.Dispose(); } mBookList.Clear(); } //Dispose public static void main(String[] args) { LibraryContainer cntrExmpl = new LibraryContainer(); try { BookComponent book1 = new BookComponent("Wizard's First Rule", "Terry Gooodkind"); cntrExmpl.Add(book1, "0812548051"); BookComponent book2 = new BookComponent("Stone of Tears", "Terry Gooodkind"); cntrExmpl.Add(book2, "0812548094"); BookComponent book3 = new BookComponent("Blood of the Fold", "Terry Gooodkind"); cntrExmpl.Add(book3, "0812551478"); BookComponent book4 = new 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: " + e.get_Message()); } ComponentCollection dataList = cntrExmpl.get_Components(); IEnumerator denum = dataList.GetEnumerator(); while (denum.MoveNext()) { BookComponent cmp = (BookComponent)denum.get_Current(); Console.WriteLine("Book Title: " + cmp.get_Title()); Console.WriteLine("Book Author: " + cmp.get_Author()); Console.WriteLine("Book ISBN: " + cmp.get_Site().get_Name()); } } //main } //LibraryContainer

System.Collections.ReadOnlyCollectionBase
System.ComponentModel.ComponentCollection


Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


ComponentCollection コンストラクタ
アセンブリ: System (system.dll 内)

Public Sub New ( _ components As IComponent() _ )
Dim components As IComponent() Dim instance As New ComponentCollection(components)
public ComponentCollection ( IComponent[] components )
public: ComponentCollection ( array<IComponent^>^ components )
public ComponentCollection ( IComponent[] components )
public function ComponentCollection ( components : IComponent[] )


BookComponent オブジェクトの配列から ComponentCollection を作成する方法を次のコード例に示します。
'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. Class LibraryContainer Implements IContainer Private m_bookList As ArrayList Public Sub New() m_bookList = New ArrayList() End Sub Public Sub Add(ByVal book As IComponent) Implements IContainer.Add 'The book will be added without creation of the ISite object. m_bookList.Add(book) End Sub Public Sub Add(ByVal book As IComponent, ByVal ISNDNNum As String) Implements IContainer.Add Dim i As Integer Dim curObj As IComponent For i = 0 To m_bookList.Count - 1 curObj = CType(m_bookList(i), IComponent) If Not curObj.Site Is Nothing Then If (curObj.Site.Name.Equals(ISNDNNum)) Then Throw New SystemException("The ISBN number already exists in the container") End If End If Next i Dim data As ISBNSite = New ISBNSite(Me, book) data.Name = ISNDNNum book.Site = data m_bookList.Add(book) End Sub Public Sub Remove(ByVal book As IComponent) Implements IContainer.Remove Dim i As Integer Dim curComp As BookComponent = CType(book, BookComponent) For i = 0 To m_bookList.Count - 1 If (curComp.Equals(m_bookList(i)) = True) Then m_bookList.RemoveAt(i) Exit For End If Next i End Sub Public ReadOnly Property Components() As ComponentCollection Implements IContainer.Components Get Dim datalist(m_bookList.Count - 1) As IComponent m_bookList.CopyTo(datalist) Return New ComponentCollection(datalist) End Get End Property Public Overridable Sub Dispose() Implements IDisposable.Dispose Dim i As Integer For i = 0 To m_bookList.Count - 1 Dim curObj As IComponent = CType(m_bookList(i), IComponent) curObj.Dispose() Next i m_bookList.Clear() End Sub Public Shared Sub Main() Dim cntrExmpl As LibraryContainer = New LibraryContainer() Try Dim book1 As BookComponent = New BookComponent("Wizard's First Rule", "Terry Gooodkind") cntrExmpl.Add(book1, "0812548051") Dim book2 As BookComponent = New BookComponent("Stone of Tears", "Terry Gooodkind") cntrExmpl.Add(book2, "0812548094") Dim book3 As BookComponent = New BookComponent("Blood of the Fold", "Terry Gooodkind") cntrExmpl.Add(book3, "0812551478") Dim book4 As BookComponent = New BookComponent("The Soul of the Fire", "Terry Gooodkind") 'This will generate an exception, because the ISBN already exists in the container. cntrExmpl.Add(book4, "0812551478") Catch e As SystemException Console.WriteLine("Error description: " + e.Message) End Try Dim datalist As ComponentCollection = cntrExmpl.Components Dim denum As IEnumerator = datalist.GetEnumerator() While (denum.MoveNext()) Dim cmp As BookComponent = CType(denum.Current, BookComponent) Console.WriteLine("Book Title: " + cmp.Title) Console.WriteLine("Book Author: " + cmp.Author) Console.WriteLine("Book ISBN: " + cmp.Site.Name) End While End Sub End Class
//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. class LibraryContainer : IContainer { private ArrayList m_bookList; public LibraryContainer() { m_bookList = new ArrayList(); } public virtual void Add(IComponent book) { //The book will be added without creation of the ISite object. m_bookList.Add(book); } public virtual void Add(IComponent book, string ISNDNNum) { for(int i =0; i < m_bookList.Count; ++i) { IComponent curObj = (IComponent)m_bookList[i]; if(curObj.Site != null) { if(curObj.Site.Name.Equals(ISNDNNum)) throw new SystemException("The ISBN number already exists in the container"); } } ISBNSite data = new ISBNSite(this, book); data.Name = ISNDNNum; book.Site = data; m_bookList.Add(book); } public virtual void Remove(IComponent book) { for(int i =0; i < m_bookList.Count; ++i) { if(book.Equals(m_bookList[i])) { m_bookList.RemoveAt(i); break; } } } public ComponentCollection Components { get { IComponent[] datalist = new BookComponent[m_bookList.Count]; m_bookList.CopyTo(datalist); return new ComponentCollection(datalist); } } public virtual void Dispose() { for(int i =0; i < m_bookList.Count; ++i) { IComponent curObj = (IComponent)m_bookList[i]; curObj.Dispose(); } m_bookList.Clear(); } static void Main(string[] args) { LibraryContainer cntrExmpl = new LibraryContainer(); try { BookComponent book1 = new BookComponent("Wizard's First Rule", "Terry Gooodkind"); cntrExmpl.Add(book1, "0812548051"); BookComponent book2 = new BookComponent("Stone of Tears", "Terry Gooodkind"); cntrExmpl.Add(book2, "0812548094"); BookComponent book3 = new BookComponent("Blood of the Fold", "Terry Gooodkind"); cntrExmpl.Add(book3, "0812551478"); BookComponent book4 = new 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: " + e.Message); } ComponentCollection datalist =cntrExmpl.Components; IEnumerator denum = datalist.GetEnumerator(); while(denum.MoveNext()) { BookComponent cmp = (BookComponent)denum.Current; Console.WriteLine("Book Title: " + cmp.Title); Console.WriteLine("Book Author: " + cmp.Author); Console.WriteLine("Book ISBN: " + cmp.Site.Name); } } }
// 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. class LibraryContainer implements IContainer { private ArrayList mBookList; public LibraryContainer() { mBookList = new ArrayList(); } //LibraryContainer public void Add(IComponent book) { // The book will be added without creation of the ISite object. mBookList.Add(book); } //Add public void Add(IComponent book, String isndNNum) throws SystemException { for (int i = 0; i < mBookList.get_Count(); ++i) { IComponent curObj = (IComponent)mBookList.get_Item(i); if (curObj.get_Site() != null) { if (curObj.get_Site().get_Name().Equals(isndNNum)) { throw new SystemException( "The ISBN number already exists in the container"); } } } ISBNSite data = new ISBNSite(this, book); data.set_Name(isndNNum); book.set_Site(data); mBookList.Add(book); } //Add public void Remove(IComponent book) { for (int i = 0; i < mBookList.get_Count(); ++i) { if (book.Equals(mBookList.get_Item(i))) { mBookList.RemoveAt(i); break; } } } //Remove /** @property */ public ComponentCollection get_Components() { IComponent dataList[] = new BookComponent[mBookList.get_Count()]; mBookList.CopyTo(dataList); return new ComponentCollection(dataList); } //get_Components public void Dispose() { for (int i = 0; i < mBookList.get_Count(); ++i) { IComponent curObj = (IComponent)mBookList.get_Item(i); curObj.Dispose(); } mBookList.Clear(); } //Dispose public static void main(String[] args) { LibraryContainer cntrExmpl = new LibraryContainer(); try { BookComponent book1 = new BookComponent("Wizard's First Rule", "Terry Gooodkind"); cntrExmpl.Add(book1, "0812548051"); BookComponent book2 = new BookComponent("Stone of Tears", "Terry Gooodkind"); cntrExmpl.Add(book2, "0812548094"); BookComponent book3 = new BookComponent("Blood of the Fold", "Terry Gooodkind"); cntrExmpl.Add(book3, "0812551478"); BookComponent book4 = new 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: " + e.get_Message()); } ComponentCollection dataList = cntrExmpl.get_Components(); IEnumerator denum = dataList.GetEnumerator(); while (denum.MoveNext()) { BookComponent cmp = (BookComponent)denum.get_Current(); Console.WriteLine("Book Title: " + cmp.get_Title()); Console.WriteLine("Book Author: " + cmp.get_Author()); Console.WriteLine("Book ISBN: " + cmp.get_Site().get_Name()); } } //main } //LibraryContainer

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


ComponentCollection プロパティ

名前 | 説明 | |
---|---|---|
![]() | Count | ReadOnlyCollectionBase インスタンスに格納されている要素の数を取得します。 ( ReadOnlyCollectionBase から継承されます。) |
![]() | Item | オーバーロードされます。 指定した名前と一致するコンポーネントをコレクションから取得します。 |

名前 | 説明 | |
---|---|---|
![]() | InnerList | ReadOnlyCollectionBase インスタンスに格納されている要素のリストを取得します。 ( ReadOnlyCollectionBase から継承されます。) |

ComponentCollection メソッド

名前 | 説明 | |
---|---|---|
![]() | CopyTo | 指定した配列インデックスを開始位置として、配列にコレクション全体をコピーします。 |
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。) |
![]() | GetEnumerator | ReadOnlyCollectionBase インスタンスを反復処理する列挙子を返します。 ( ReadOnlyCollectionBase から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 ( Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 ( Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 ( Object から継承されます。) |

ComponentCollection メンバ
IComponent オブジェクトのコレクション用の読み取り専用コンテナを提供します。
ComponentCollection データ型で公開されるメンバを以下の表に示します。


名前 | 説明 | |
---|---|---|
![]() | Count | ReadOnlyCollectionBase インスタンスに格納されている要素の数を取得します。(ReadOnlyCollectionBase から継承されます。) |
![]() | Item | オーバーロードされます。 指定した名前と一致するコンポーネントをコレクションから取得します。 |

名前 | 説明 | |
---|---|---|
![]() | InnerList | ReadOnlyCollectionBase インスタンスに格納されている要素のリストを取得します。(ReadOnlyCollectionBase から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | CopyTo | 指定した配列インデックスを開始位置として、配列にコレクション全体をコピーします。 |
![]() | Equals | オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。) |
![]() | GetEnumerator | ReadOnlyCollectionBase インスタンスを反復処理する列挙子を返します。 (ReadOnlyCollectionBase から継承されます。) |
![]() | GetHashCode | 特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。) |
![]() | GetType | 現在のインスタンスの Type を取得します。 (Object から継承されます。) |
![]() | ReferenceEquals | 指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。) |
![]() | ToString | 現在の Object を表す String を返します。 (Object から継承されます。) |

名前 | 説明 | |
---|---|---|
![]() | Finalize | Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。) |
![]() | MemberwiseClone | 現在の Object の簡易コピーを作成します。 (Object から継承されます。) |

- ComponentCollectionのページへのリンク