ISite Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет функции, необходимые для сайтов.
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
- Производный
- Атрибуты
- Реализации
Примеры
В следующем примере демонстрируется реализация ISite, IComponentи 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
{
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) |
Получает службу типа |
GetKeyedServices(IServiceProvider, Type, Object) |
Получает перечисление служб типа |
GetKeyedServices<T>(IServiceProvider, Object) |
Получает перечисление служб типа |
GetRequiredKeyedService(IServiceProvider, Type, Object) |
Получает службу типа |
GetRequiredKeyedService<T>(IServiceProvider, Object) |
Получает службу типа |
CreateAsyncScope(IServiceProvider) |
Создает интерфейс AsyncServiceScope, который может использоваться для разрешения служб с ограниченной областью. |
CreateScope(IServiceProvider) |
Создает интерфейс IServiceScope, который может использоваться для разрешения служб с ограниченной областью. |
GetRequiredService(IServiceProvider, Type) |
Возвращает службу типа |
GetRequiredService<T>(IServiceProvider) |
Возвращает службу типа |
GetService<T>(IServiceProvider) |
Возвращает службу типа |
GetServices(IServiceProvider, Type) |
Возвращает перечисление служб типа |
GetServices<T>(IServiceProvider) |
Возвращает перечисление служб типа |
GetFakeLogCollector(IServiceProvider) |
Возвращает объект , который собирает записи журнала, отправляемые в поддельные средства ведения журнала. |
GetFakeRedactionCollector(IServiceProvider) |
Возвращает экземпляр сборщика поддельных средств редактирования из контейнера внедрения зависимостей. |