ISite 介面

參考

定義

命名空間:: System.ComponentModel

組件:: System.ComponentModel.Primitives.dll

組件:: System.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

提供站台所需的功能。

public interface class ISite : IServiceProvider

public interface ISite : IServiceProvider

[System.Runtime.InteropServices.ComVisible(true)]
public interface ISite : IServiceProvider

type ISite = interface
    interface IServiceProvider

[<System.Runtime.InteropServices.ComVisible(true)>]
type ISite = interface
    interface IServiceProvider

Public Interface ISite
Implements IServiceProvider

衍生: System.ComponentModel.INestedSite

System.Workflow.ComponentModel.Design.TypeBrowserDialog

屬性: ComVisibleAttribute

實作: IServiceProvider

範例

下列範例示範、和 IContainer 的ISite IComponent實作，以用於連結庫容器。

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

    '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 至 Container ，並啟用它們之間的通訊，並提供容器管理其元件的方式。

月臺也可以作為容器特定、每個元件資訊的存放庫，例如元件名稱。

給實施者的注意事項

若要成為月臺，類別必須實作 ISite 介面。

屬性

Component	當由類別實作時，取得與 ISite 相關聯的元件。
Container	當由類別實作時，取得與 IContainer 相關聯的 ISite。
DesignMode	判斷由類別實作時，元件是否處於設計模式。
Name	當由類別實作時，取得或設定與 ISite 相關聯的元件名稱。

方法

GetService(Type)

取得指定類型的服務物件。

(繼承來源 IServiceProvider)

擴充方法

GetKeyedService<T>(IServiceProvider, Object)	從IServiceProvider取得型`T`別的服務。
GetKeyedServices(IServiceProvider, Type, Object)	從IServiceProvider取得型`serviceType`別服務的列舉。
GetKeyedServices<T>(IServiceProvider, Object)	從IServiceProvider取得型`T`別服務的列舉。
GetRequiredKeyedService(IServiceProvider, Type, Object)	從IServiceProvider取得型`serviceType`別的服務。
GetRequiredKeyedService<T>(IServiceProvider, Object)	從IServiceProvider取得型`T`別的服務。
CreateAsyncScope(IServiceProvider)	建立可用來解析已設定範圍服務的新 AsyncServiceScope。
CreateScope(IServiceProvider)	建立可用來解析已設定範圍服務的新 IServiceScope。
GetRequiredService(IServiceProvider, Type)	從 IServiceProvider 取得 `serviceType` 類型的服務。
GetRequiredService<T>(IServiceProvider)	從 IServiceProvider 取得 `T` 類型的服務。
GetService<T>(IServiceProvider)	從 IServiceProvider 取得 `T` 類型的服務。
GetServices(IServiceProvider, Type)	從 IServiceProvider 取得類型 `serviceType` 服務的列舉。
GetServices<T>(IServiceProvider)	從 IServiceProvider 取得類型 `T` 服務的列舉。
GetFakeLogCollector(IServiceProvider)	取得對象，這個物件會收集傳送至假記錄器的記錄檔記錄。
GetFakeRedactionCollector(IServiceProvider)	從相依性插入容器取得假的重構函式收集器實例。

適用於

產品	版本
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1

分享方式：

ISite 介面

定義

範例

備註

給實施者的注意事項

屬性

方法

擴充方法

適用於

另請參閱

更多資源