IComponent 接口

提供所有组件需要的功能。

**命名空间:**System.ComponentModel
**程序集:**System（在 system.dll 中）

语法

声明
<ComVisibleAttribute(True)> _
Public Interface IComponent
    Inherits IDisposable
用法
Dim instance As IComponent

[ComVisibleAttribute(true)] 
public interface IComponent : IDisposable

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

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

ComVisibleAttribute(true) 
public interface IComponent extends IDisposable

备注

Component 是 IComponent 的默认实现，可作为公共语言运行库中所有组件的基类使用。

不能在容器中包含组件。在此上下文中，包容是指逻辑包容，而不是直观包容。可以在多种方案中使用组件和容器，包括可视化方案和非可视化方案。

System.Windows.Forms.Control 从 Component（IComponent 的默认实现）继承。

组件主要通过由容器提供的 ISite（这是容器特定的基于组件的信息储存库）与其容器进行交互。

给实现者的说明 要成为组件，类必须实现 IComponent 接口，并提供不需要参数或只需一个类型为 IContainer 的参数的基本构造函数。有关如何实现 IComponent 的更多信息，请参见 使用组件编程。

示例

   'The following example demonstrates the implementation of 
    'ISite, IComponent, and IContainer for use in a simple library container.
    '
    'This example imports the System, System.ComponentModel, and System.Collections
    'namespaces.

    'This code segment implements the ISite and IComponent interfaces.
    'The implementation of the IContainer interface can be seen in the documentation 
    'of IContainer.

    'Implement the ISite interface.

    'The ISBNSite class represents the ISBN name of the book component
    
Class ISBNSite
    Implements ISite
    Private m_curComponent As IComponent
    Private m_curContainer As IContainer
    Private m_bDesignMode As Boolean
    Private m_ISBNCmpName As String

    Public Sub New(ByVal actvCntr As IContainer, ByVal prntCmpnt As IComponent)
        m_curComponent = prntCmpnt
        m_curContainer = actvCntr
        m_bDesignMode = False
        m_ISBNCmpName = Nothing
    End Sub

    'Support the ISite interface.
    Public ReadOnly Property Component() As IComponent Implements ISite.Component
        Get
            Return m_curComponent
        End Get
    End Property

    Public ReadOnly Property Container() As IContainer Implements ISite.Container
        Get
            Return m_curContainer
        End Get
    End Property

    Public ReadOnly Property DesignMode() As Boolean Implements ISite.DesignMode
        Get
            Return m_bDesignMode
        End Get
    End Property

    Public Property Name() As String Implements ISite.Name
        Get
            Return m_ISBNCmpName
        End Get
        Set(ByVal Value As String)
            m_ISBNCmpName = Value
        End Set
    End Property

    'Support the IServiceProvider interface.
    Public Function GetService(ByVal serviceType As Type) As Object Implements IServiceProvider.GetService
        'This example does not use any service object.
        GetService = Nothing
    End Function
End Class

'The BookComponent class represents the book component of the library container.
Class BookComponent
    Implements IComponent
    Public Event Disposed As EventHandler Implements IComponent.Disposed
    Private m_curISBNSite As ISite
    Private m_bookTitle As String
    Private m_bookAuthor As String

    Public Sub New(ByVal Title As String, ByVal Author As String)
        m_curISBNSite = Nothing
        m_bookTitle = Title
        m_bookAuthor = Author
    End Sub

    Public ReadOnly Property Title() As String
        Get
            Return m_bookTitle
        End Get
    End Property

    Public ReadOnly Property Author() As String
        Get
            Return m_bookAuthor
        End Get
    End Property

    Public Sub Dispose() Implements IDisposable.Dispose
        'There is nothing to clean.
        RaiseEvent Disposed(Me, EventArgs.Empty)
    End Sub

    Public Property Site() As ISite Implements IComponent.Site
        Get
            Return m_curISBNSite
        End Get
        Set(ByVal Value As ISite)
            m_curISBNSite = Value
        End Set
    End Property

    Public Overloads Function Equals(ByVal cmp As Object) As Boolean
        Dim cmpObj As BookComponent = CType(cmp, BookComponent)
        If (Me.Title.Equals(cmpObj.Title) And Me.Author.Equals(cmpObj.Author)) Then
            Equals = True
        Else
            Equals = False
        End If
    End Function

    Public Overrides Function GetHashCode() As Integer
        GetHashCode = MyBase.GetHashCode()
    End Function

End Class

/// <summary>
/// The following example demonstrates the implementation of 
/// ISite, IComponent, and IContainer for use in a simple library container.
///
/// This example uses the System, System.ComponentModel, and System.Collections
/// namespaces.
/// </summary>

//This code segment implements the ISite and IComponent interfaces.
//The implementation of the IContainer interface can be seen in the documentation 
//of IContainer.

//Implement the ISite interface.

// The ISBNSite class represents the ISBN name of the book component
class ISBNSite : ISite
{
    private IComponent m_curComponent;
    private IContainer m_curContainer;
    private bool m_bDesignMode;
    private string m_ISBNCmpName;

    public ISBNSite(IContainer actvCntr, IComponent prntCmpnt)
    {
        m_curComponent = prntCmpnt;
        m_curContainer = actvCntr;
        m_bDesignMode = false;
        m_ISBNCmpName = null;
    }

    //Support the ISite interface.
    public virtual IComponent Component
    {
        get
        {
            return m_curComponent;
        }
    }

    public virtual IContainer Container
    {
        get
        {
            return m_curContainer;
        }
    }
    
    public virtual bool DesignMode
    {
        get
        {
            return m_bDesignMode;
        }
    }

    public virtual string Name
    {
        get
        {
            return m_ISBNCmpName;
        }

        set
        {
            m_ISBNCmpName = value;
        }
    }

    //Support the IServiceProvider interface.
    public virtual object GetService(Type serviceType)
    {
        //This example does not use any service object.
        return null;
    }

}

// The BookComponent class represents the book component of the library container.

// This class implements the IComponent interface.

class BookComponent : IComponent
{
    public event EventHandler Disposed;
    private ISite m_curISBNSite;
    private string m_bookTitle;
    private string m_bookAuthor;

    public BookComponent(string Title, string Author)
    {
        m_curISBNSite = null;
        Disposed = null;
        m_bookTitle = Title;
        m_bookAuthor = Author;
    }

    public string Title
    {
        get
        {
            return m_bookTitle;
        }
    }

    public string Author
    {
        get
        {
            return m_bookAuthor;
        }
    }

    public virtual void Dispose()
    {    
        //There is nothing to clean.
        if(Disposed != null)
            Disposed(this,EventArgs.Empty);
    }

    public virtual ISite Site
    {
        get
        {
            return m_curISBNSite;
        }
        set
        {
            m_curISBNSite = value;
        }
    }

    public override bool Equals(object cmp)
    {
        BookComponent cmpObj = (BookComponent)cmp;
        if(this.Title.Equals(cmpObj.Title) && this.Author.Equals(cmpObj.Author))
            return true;

        return false;
    }

    public override int GetHashCode()
    {
        return base.GetHashCode();
    }
}

/// <summary>
/// The following example demonstrates the implementation of 
/// ISite, IComponent, and IContainer for use in a simple library container.
/// This example uses the System, System.ComponentModel, and System.Collections
/// namespaces.
/// </summary>

// This code segment implements the ISite and IComponent interfaces.
// The implementation of the IContainer interface can be seen in the 
// documentation of IContainer.

// Implement the ISite interface.
// The ISBNSite class represents the ISBN name of the book component
class ISBNSite implements ISite
{
    private IComponent mCurComponent;
    private IContainer mCurContainer;
    private boolean mbDesignMode;
    private String mISBNCmpName;

    public ISBNSite(IContainer actvCntr, IComponent prntCmpnt)
    {
        mCurComponent = prntCmpnt;
        mCurContainer = actvCntr;
        mbDesignMode = false;
        mISBNCmpName = null;
    } //ISBNSite

    //Support the ISite interface.
    /** @property 
     */
    public IComponent get_Component()
    {
        return mCurComponent;
    } //get_Component

    /** @property 
     */
    public IContainer get_Container()
    {
        return mCurContainer;
    } //get_Container

    /** @property 
     */
    public boolean get_DesignMode()
    {
        return mbDesignMode;
    } //get_DesignMode

    /** @property 
     */
    public String get_Name()
    {
        return mISBNCmpName;
    } //get_Name

    /** @property 
     */
    public void set_Name(String value)
    {
        mISBNCmpName = value;
    } //set_Name

    // Support the IServiceProvider interface.
    public Object GetService(Type serviceType)
    {
        // This example does not use any service object.
        return null;
    } //GetService
} //ISBNSite

// The BookComponent class represents the book component of the library 
// container. This class implements the IComponent interface.
class BookComponent implements IComponent
{
    public EventHandler disposed = null;

    /** @event 
     */
    public void add_Disposed(EventHandler p)
    {
        disposed = (EventHandler)System.Delegate.Combine(disposed, p);
    } //add_Disposed

    /** @event 
     */
    public void remove_Disposed(EventHandler p)
    {
        disposed = (EventHandler)System.Delegate.Remove(disposed, p);
    } //remove_Disposed

    private ISite mCurISBNSite;
    private String mBookTitle;
    private String mBookAuthor;

    public BookComponent(String title, String author)
    {
        mCurISBNSite = null;
        disposed = null;
        mBookTitle = title;
        mBookAuthor = author;
    } //BookComponent

    /** @property 
     */
    public String get_Title()
    {
        return mBookTitle;
    } //get_Title

    /** @property 
     */
    public String get_Author()
    {
        return mBookAuthor;
    } //get_Author

    public void Dispose()
    {
        // There is nothing to clean.
        if (disposed != null) {
            disposed.Invoke(this, EventArgs.Empty);
        }
    } //Dispose

    /** @property 
     */
    public ISite get_Site()
    {
        return mCurISBNSite;
    } //get_Site

    /** @property 
     */
    public void set_Site(ISite value)
    {
        mCurISBNSite = value;
    } //set_Site

    public boolean Equals(Object cmp)
    {
        BookComponent cmpObj = (BookComponent)cmp;
        if (this.get_Title().Equals(cmpObj.get_Title()) && this.get_Author().
                Equals(cmpObj.get_Author())) {
            return true;
        }
        return false;
    } //Equals

    public int GetHashCode()
    {
        return super.GetHashCode();
    } //GetHashCode
} //BookComponent

平台

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

请参见

参考

IComponent 成员
System.ComponentModel 命名空间
Container 类
IContainer
ISite
System.Windows.Forms.Control