ISite Interfejs

Definicja

Udostępnia funkcje wymagane przez witryny.

C#
public interface ISite : IServiceProvider
C#
[System.Runtime.InteropServices.ComVisible(true)]
public interface ISite : IServiceProvider
Pochodne
Atrybuty
Implementuje

Przykłady

W poniższym przykładzie pokazano implementację elementów ISite, IComponenti IContainer do użycia w kontenerze biblioteki.

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

Uwagi

Lokacje wiążą element z elementem ComponentContainer i umożliwiają komunikację między nimi, a także umożliwiają kontenerowi zarządzanie jego składnikami.

Witryny mogą również służyć jako repozytorium informacji specyficznych dla kontenera dla poszczególnych składników, takich jak nazwa składnika.

Uwagi dotyczące implementowania

Aby być lokacją, klasa musi zaimplementować ISite interfejs.

Właściwości

Component

Pobiera składnik skojarzony z ISite elementem po zaimplementowaniu przez klasę.

Container

Pobiera element IContainer skojarzony z elementem ISite po zaimplementowaniu przez klasę.

DesignMode

Określa, czy składnik jest w trybie projektowania, gdy jest implementowany przez klasę.

Name

Pobiera lub ustawia nazwę składnika skojarzonego z ISite elementem po zaimplementowaniu przez klasę.

Metody

GetService(Type)

Pobiera obiekt usługi określonego typu.

(Odziedziczone po IServiceProvider)

Metody rozszerzania

GetKeyedService<T>(IServiceProvider, Object)

Pobiera usługę typu T z klasy IServiceProvider.

GetKeyedServices(IServiceProvider, Type, Object)

Pobiera wyliczenie usług typu serviceType z klasy IServiceProvider.

GetKeyedServices<T>(IServiceProvider, Object)

Pobiera wyliczenie usług typu T z klasy IServiceProvider.

GetRequiredKeyedService(IServiceProvider, Type, Object)

Pobiera usługę typu serviceType z klasy IServiceProvider.

GetRequiredKeyedService<T>(IServiceProvider, Object)

Pobiera usługę typu T z klasy IServiceProvider.

CreateAsyncScope(IServiceProvider)

Tworzy nowy AsyncServiceScope , który może służyć do rozwiązywania problemów z usługami o określonym zakresie.

CreateScope(IServiceProvider)

Tworzy nowy IServiceScope , który może służyć do rozwiązywania problemów z usługami o określonym zakresie.

GetRequiredService(IServiceProvider, Type)

Pobierz usługę typu serviceType z elementu IServiceProvider.

GetRequiredService<T>(IServiceProvider)

Pobierz usługę typu T z elementu IServiceProvider.

GetService<T>(IServiceProvider)

Pobierz usługę typu T z elementu IServiceProvider.

GetServices(IServiceProvider, Type)

Pobierz wyliczenie usług typu serviceType z klasy IServiceProvider.

GetServices<T>(IServiceProvider)

Pobierz wyliczenie usług typu T z klasy IServiceProvider.

GetFakeLogCollector(IServiceProvider)

Pobiera obiekt zbierający rekordy dziennika wysyłane do fałszywego rejestratora.

GetFakeRedactionCollector(IServiceProvider)

Pobiera fałszywe wystąpienie modułu zbierającego redactor z kontenera wstrzykiwania zależności.

Dotyczy

Produkt Wersje
.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

Zobacz też