ISite Interfaccia

Definizione

Fornisce le funzionalità richieste da tutti i siti.

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

Esempio

Nell'esempio seguente viene illustrata l'implementazione di ISite, IComponente IContainer per l'uso in un contenitore di libreria.

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

Commenti

I siti associano un oggetto Component a un Container e abilitano la comunicazione tra di essi, oltre a fornire un modo per gestire i relativi componenti.

I siti possono anche fungere da repository per informazioni specifiche del contenitore, per componente, ad esempio il nome del componente.

Note per gli implementatori

Per essere un sito, una classe deve implementare l'interfaccia ISite .

Proprietà

Component

Ottiene il componente associato a ISite quando viene implementato da un classe.

Container

Ottiene l'oggetto IContainer associato a ISite quando viene implementato da una classe.

DesignMode

Consente di determinare se il componente è in modalità progettazione quando viene implementato da un classe.

Name

Ottiene o imposta il nome del componente associato all'oggetto ISite quando viene implementato da un classe.

Metodi

GetService(Type)

Ottiene l'oggetto servizio del tipo specificato.

(Ereditato da IServiceProvider)

Metodi di estensione

GetKeyedService<T>(IServiceProvider, Object)

Ottiene un servizio di tipo T da IServiceProvider.

GetKeyedServices(IServiceProvider, Type, Object)

Ottiene un'enumerazione dei servizi di tipo serviceType dall'oggetto IServiceProvider.

GetKeyedServices<T>(IServiceProvider, Object)

Ottiene un'enumerazione dei servizi di tipo T dall'oggetto IServiceProvider.

GetRequiredKeyedService(IServiceProvider, Type, Object)

Ottiene un servizio di tipo serviceType da IServiceProvider.

GetRequiredKeyedService<T>(IServiceProvider, Object)

Ottiene un servizio di tipo T da IServiceProvider.

CreateAsyncScope(IServiceProvider)

Crea un nuovo oggetto AsyncServiceScope che è possibile usare per risolvere i servizi con ambito.

CreateScope(IServiceProvider)

Crea un nuovo oggetto IServiceScope che è possibile usare per risolvere i servizi con ambito.

GetRequiredService(IServiceProvider, Type)

Ottiene il servizio di tipo serviceType da IServiceProvider.

GetRequiredService<T>(IServiceProvider)

Ottiene il servizio di tipo T da IServiceProvider.

GetService<T>(IServiceProvider)

Ottiene il servizio di tipo T da IServiceProvider.

GetServices(IServiceProvider, Type)

Ottiene un'enumerazione di servizi di tipo serviceType da IServiceProvider.

GetServices<T>(IServiceProvider)

Ottiene un'enumerazione di servizi di tipo T da IServiceProvider.

GetFakeLogCollector(IServiceProvider)

Ottiene l'oggetto che raccoglie i record di log inviati al logger falso.

GetFakeRedactionCollector(IServiceProvider)

Ottiene l'istanza dell'agente di raccolta redactor falso dal contenitore di inserimento delle dipendenze.

Si applica a

Prodotto Versioni
.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

Vedi anche