IComponent インターフェイス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
すべてのコンポーネントに必要な機能を提供します。
public interface class IComponent : IDisposable
[System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ComponentConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
public interface IComponent : IDisposable
public interface IComponent : IDisposable
[<System.ComponentModel.TypeConverter(typeof(System.ComponentModel.ComponentConverter))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type IComponent = interface
interface IDisposable
type IComponent = interface
interface IDisposable
Public Interface IComponent
Implements IDisposable
- 派生
- 属性
- 実装
例
次のコード例では、 IComponent、 ISite、および IContainer インターフェイスを実装する方法を示します。
/// <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
{
readonly IComponent m_curComponent;
readonly IContainer m_curContainer;
readonly bool m_bDesignMode;
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 => m_curComponent;
public virtual IContainer Container => m_curContainer;
public virtual bool DesignMode => m_bDesignMode;
public virtual string Name
{
get => m_ISBNCmpName;
set => m_ISBNCmpName = value;
}
//Support the IServiceProvider interface.
public virtual object GetService(Type serviceType) =>
//This example does not use any service object.
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;
ISite m_curISBNSite;
public BookComponent(string Title, string Author)
{
m_curISBNSite = null;
Disposed = null;
this.Title = Title;
this.Author = Author;
}
public string Title { get; }
public string Author { get; }
public virtual void Dispose() =>
//There is nothing to clean.
Disposed?.Invoke(this, EventArgs.Empty);
public virtual ISite Site
{
get => m_curISBNSite;
set => m_curISBNSite = value;
}
public override bool Equals(object cmp)
{
BookComponent cmpObj = (BookComponent)cmp;
return Title.Equals(cmpObj.Title) && Author.Equals(cmpObj.Author);
}
public override int GetHashCode() => base.GetHashCode();
}
'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
注釈
Component は IComponent の既定の実装であり、共通言語ランタイムのすべてのコンポーネントの基底クラスとして機能します。
コンテナーにコンポーネントを含めることができます。 このコンテキストでは、包含は視覚的包含ではなく論理包含を指します。 コンポーネントとコンテナーは、ビジュアルと非ビジュアルの両方のさまざまなシナリオで使用できます。
System.Windows.Forms.Control は、IComponent の既定の実装である Component から継承します。
コンポーネントは、主にコンテナーによって提供される ISiteを介してコンテナーと対話します。これは、コンテナー固有のコンポーネントごとの情報のリポジトリです。
注意 (実装者)
コンポーネントにするには、クラスは IComponent インターフェイスを実装し、パラメーターを必要としない基本的なコンストラクターまたは型 IContainerの 1 つのパラメーターを提供する必要があります。
プロパティ
| 名前 | 説明 |
|---|---|
| Site |
ISiteに関連付けられているIComponentを取得または設定します。 |
メソッド
| 名前 | 説明 |
|---|---|
| Dispose() |
アンマネージド リソースの解放、解放、またはリセットに関連付けられているアプリケーション定義のタスクを実行します。 (継承元 IDisposable) |
イベント
| 名前 | 説明 |
|---|---|
| Disposed |
コンポーネントの Disposed イベントを処理するメソッドを表します。 |