Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

IComponent-Schnittstelle

Stellt Funktionen bereit, die von allen Komponenten benötigt werden.

Namespace: System.ComponentModel
Assembly: System (in system.dll)

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

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

Sie können Komponenten in einem Container kapseln. In diesem Kontext bezieht sich Kapselung auf die logische Unterordnung, nicht auf die visuelle Einbettung. Sie können Komponenten und Container in verschiedenen Szenarien mit sowohl visuellen als auch nicht visuellen Bestandteilen verwenden.

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

Eine Komponente interagiert mit dem Container primär über eine vom Container bereitgestellte ISite, die ein Repository der containerspezifischen, für die einzelnen Komponenten verfügbaren Informationen darstellt.

Hinweise für Implementierer Damit eine Klasse als Komponente gilt, muss sie die IComponent-Schnittstelle implementieren und einen einfachen Konstruktor bereitstellen, für den kein Parameter oder nur ein Parameter vom Typ IContainer erforderlich ist. Weitere Informationen über das Implementieren von IComponent finden Sie unter Programmieren mit Komponenten.

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0
Anzeigen: