IComponent Schnittstelle

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.Primitives.dll

Stellt die für alle Komponenten erforderliche Funktionalität bereit.

C#

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

Abgeleitet

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

Attribute

TypeConverterAttribute

Implementiert

IDisposable

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die IComponentSchnittstellen , ISiteund IContainer implementiert werden.

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

Hinweise

Component ist die Standardimplementierung von IComponent und dient als Basisklasse für alle Komponenten in der Common Language Runtime.

Sie können Komponenten in einem Container enthalten. In diesem Kontext bezieht sich Containment auf logische Eindämmung, nicht auf visuelle Eindämmung. Sie können Komponenten und Container in einer Vielzahl von Szenarien verwenden, sowohl visuell als auch nicht visuell.

System.Windows.Forms.Control erbt von Component, der Standardimplementierung von IComponent.

Eine Komponente interagiert mit ihrem Container hauptsächlich über einen vom Container bereitgestellten ISite, bei dem es sich um ein Repository mit containerspezifischen Informationen pro Komponente handelt.

Hinweise für Ausführende

Um eine Komponente zu sein, muss eine Klasse die IComponent -Schnittstelle implementieren und einen grundlegenden Konstruktor bereitstellen, der keine Parameter oder einen einzelnen Parameter vom Typ IContainererfordert.

Eigenschaften

Site	Ruft den ISite ab, der dem IComponent zugeordnet ist, oder legt diesen fest.

Methoden

Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Geerbt von IDisposable)

Ereignisse

Disposed

Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt.

Gilt für:

Weitere Informationen

• Container
• IContainer
• ISite
• Control