IContainer インターフェイス

[アーティクル]
03/28/2008

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

この型のすべてのメンバの一覧については、IContainer メンバを参照してください。

System.IDisposable
System.ComponentModel.IContainer

<ComVisible(True)>
Public Interface IContainer   Inherits IDisposable
[C#]
[ComVisible(true)]
public interface IContainer : IDisposable
[C++]
[ComVisible(true)]
public __gc __interface IContainer : public IDisposable
[JScript]
public
   ComVisible(true)
interface IContainer implements IDisposable

IContainer を実装するクラス

クラス	説明
Container	0 個以上のコンポーネントをカプセル化します。

解説

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

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

使用例

 
'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
        Dim i As Integer
        
        m_bookList.CopyTo(datalist)
        Return New ComponentCollection(datalist)
    End Get
End Property

Public Sub Dispose() Implements IContainer.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 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);
        }
    }
}

[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.

__gc class LibraryContainer : public IContainer
{
private:

    ArrayList* m_bookList;

public:

    LibraryContainer()
    {
        m_bookList = new 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->Item[i]);
            if(curObj->Site != 0)
            {
                if(curObj->Site->Name->Equals(ISNDNNum))
                    throw new SystemException(S"The ISBN number already exists in the container");
            }
        }

        ISBNSite* data = new 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->Item[i]))
            {
                m_bookList->RemoveAt(i);
                break;
            }
        }
    }

    __property ComponentCollection* get_Components()
    {
        IComponent* datalist[] = new BookComponent*[m_bookList->Count];
        m_bookList->CopyTo(datalist);
        return new ComponentCollection(datalist);
    }

    virtual void Dispose()
    {
        for(int i =0; i < m_bookList->Count; ++i)
        {
            IComponent* curObj = static_cast<IComponent*>(m_bookList->Item[i]);
            curObj->Dispose();
        }

        m_bookList->Clear();
    }

    static void Main()
    {
        LibraryContainer* cntrExmpl = new LibraryContainer();

        try
        {
            BookComponent* book1 = new BookComponent(S"Wizard's First Rule", S"Terry Gooodkind");
            cntrExmpl->Add(book1, S"0812548051");
            BookComponent* book2 = new BookComponent(S"Stone of Tears", S"Terry Gooodkind");
            cntrExmpl->Add(book2, S"0812548094");
            BookComponent* book3 = new BookComponent(S"Blood of the Fold", S"Terry Gooodkind");
            cntrExmpl->Add(book3, S"0812551478");
            BookComponent* book4 = new BookComponent(S"The Soul of the Fire", S"Terry Gooodkind");
            //This will generate exception because the ISBN already exists in the container.
            cntrExmpl->Add(book4, S"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(S"Book Title: {0}", cmp->Title);
            Console::WriteLine("Book Author: {0}", cmp->Author);
            Console::WriteLine("Book ISBN: {0}", cmp->Site->Name);
        }
    }
};

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

名前空間: System.ComponentModel

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: System (System.dll 内)

参照

IContainer メンバ | System.ComponentModel 名前空間 | Component | IComponent | Container

次の方法で共有

IContainer インターフェイス

IContainer を実装するクラス

解説

使用例

必要条件

参照

その他のリソース