ISite 接口

定义

命名空间:

System.ComponentModel

程序集:

System.ComponentModel.Primitives.dll

提供站点所需的功能。

C#

public interface ISite : IServiceProvider

派生

System.ComponentModel.INestedSite

System.Workflow.ComponentModel.Design.TypeBrowserDialog

实现

IServiceProvider

示例

以下示例演示在库容器中使用的 、 IComponent和 IContainer 的ISite实现。

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 并 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)	从依赖项注入容器中获取假的重设函数收集器实例。

适用于

另请参阅

• Component
• IComponent
• Container
• IContainer
• 扩展设计时支持