IComponent 接口

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.Primitives.dll

提供全部组件所需的功能。

C#

[System.ComponentModel.TypeConverter("System.ComponentModel.ComponentConverter, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089")]
public interface IComponent : IDisposable

派生

System.ComponentModel.Component

System.ComponentModel.MarshalByValueComponent

System.Web.HttpApplication

System.Web.UI.Control

System.Windows.Forms.BindableComponent

System.Windows.Forms.DataGridViewColumn

System.Windows.Forms.IBindableComponent

System.Windows.Forms.ToolStrip

System.Windows.Forms.ToolStripItem

System.Windows.Forms.ToolStripOverflow

System.Windows.Forms.ToolStripPanel

System.Windows.Forms.ToolStripPanelRow

System.Workflow.ComponentModel.DependencyObject

属性

TypeConverterAttribute

实现

IDisposable

示例

下面的代码示例演示如何实现 IComponent、 ISite和 IContainer 接口。

C#

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

注解

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

可以在容器中包含组件。 在此上下文中，包含是指逻辑包含，而不是视觉包含。 可以在视觉对象和非视觉对象的各种方案中使用组件和容器。

System.Windows.Forms.Control 继承自 Component，这是 的默认 IComponent实现。

组件主要通过容器提供的 ISite交互，该容器是特定于容器的每个组件信息的存储库。

实施者说明

若要成为组件，类必须实现 IComponent 接口并提供不需要任何参数的基本构造函数或类型的 IContainer单个参数。

属性

Site	获取或设置与 ISite 关联的 IComponent。

方法

Dispose()

执行与释放或重置非托管资源关联的应用程序定义的任务。 (继承自 IDisposable)

事件

Disposed

表示处理组件的 Disposed 事件的方法。

适用于

另请参阅

• Container
• IContainer
• ISite
• Control