IContainer

.NET Framework クラス ライブラリ リファレンス

IContainer インターフェイス

コンテナの機能を提供します。コンテナとは、論理上 0 個以上のコンポーネントを格納しているオブジェクトです。

名前空間: System.ComponentModel
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Interface IContainer
    Inherits IDisposable

Visual Basic (使用法)

Dim instance As IContainer

C#

[ComVisibleAttribute(true)] 
public interface IContainer : IDisposable

C++

[ComVisibleAttribute(true)] 
public interface class IContainer : IDisposable

J#

/** @attribute ComVisibleAttribute(true) */ 
public interface IContainer extends IDisposable

JScript

ComVisibleAttribute(true) 
public interface IContainer extends IDisposable

解説

コンテナとは、0 個以上のコンポーネントをカプセル化し、追跡するオブジェクトです。この場合、コンテインメントとは、ビジュアル コンテインメントではなく論理的なコンテインメントを意味します。ビジュアルおよび非ビジュアルの両方を含むさまざまなシナリオで、コンポーネントとコンテナを使用できます。

実装時の注意 コンテナでは、クラスはコンポーネントの追加、削除、および検索のためのメソッドをサポートしている IContainer インターフェイスを実装する必要があります。

使用例

Visual Basic

    '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

C#

//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);
        }
    }
}

J#

// 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 CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
IContainer メンバ
System.ComponentModel 名前空間
Component クラス
IComponent インターフェイス
Container クラス

IContainer プロパティ

パブリック プロパティ

	名前	説明
	Components	IContainer 内のすべてのコンポーネントを取得します。

参照

関連項目

IContainer インターフェイス
System.ComponentModel 名前空間
Component クラス
IComponent インターフェイス
Container クラス

IContainer メソッド

パブリック メソッド

	名前	説明
	Add	オーバーロードされます。 指定したコンポーネントを IContainer に追加します。
	Remove	IContainer からコンポーネントを削除します。

参照

関連項目

IContainer インターフェイス
System.ComponentModel 名前空間
Component クラス
IComponent インターフェイス
Container クラス

IContainer メンバ

コンテナの機能を提供します。コンテナとは、論理上 0 個以上のコンポーネントを格納しているオブジェクトです。

IContainer データ型で公開されるメンバを以下の表に示します。

パブリック プロパティ

	名前	説明
	Components	IContainer 内のすべてのコンポーネントを取得します。

パブリック メソッド

	名前	説明
	Add	オーバーロードされます。 指定したコンポーネントを IContainer に追加します。
	Remove	IContainer からコンポーネントを削除します。

参照

関連項目

IContainer インターフェイス
System.ComponentModel 名前空間
Component クラス
IComponent インターフェイス
Container クラス