IInstanceContextProvider Interfaccia

Definizione

Implementare questa interfaccia per partecipare alla creazione o alla scelta di un oggetto InstanceContext, soprattutto per abilitare le sessioni condivise.Implement to participate in the creation or choosing of a InstanceContext object, especially to enable shared sessions.

public interface class IInstanceContextProvider
public interface IInstanceContextProvider
type IInstanceContextProvider = interface
Public Interface IInstanceContextProvider

Commenti

Implementare l'interfaccia IInstanceContextProvider per fornire l'oggetto System.ServiceModel.InstanceContext appropriato al sistema.Implement the IInstanceContextProvider interface to provide the appropriate System.ServiceModel.InstanceContext object to the system. In genere, questa interfaccia viene implementata per supportare sessioni condivise, abilitare il pooling delle istanze di servizio, controllare la durata delle istanze del servizio o raggruppare i contesti fra client.Typically, this interface is implemented to support shared sessions, enable service instance pooling, control lifetimes of service instances, or to group contexts among clients.

Ad esempio, per implementare la condivisione, inserire un'interfaccia IInstanceContextProvider personalizzata per decidere quale sessione o chiamate da un client è associata con quale oggetto InstanceContext.For example, to implement sharing, insert a custom IInstanceContextProvider to decide which session or call from a client is associated with which InstanceContext object. Per un esempio in cui viene illustrata la condivisione dei contesti di istanza, vedere InstanceContextSharing.For an example that demonstrates the sharing of instance contexts, see InstanceContextSharing.

Nota

Quando un IInstanceContextProvider oggetto viene inserito in Windows Communication Foundation (WCF), la proprietà normale che controlla la creazione InstanceContext di oggetti ( ServiceBehaviorAttribute.InstanceContextMode la proprietà) non viene più verificata e non ha alcun effetto.When an IInstanceContextProvider is inserted into Windows Communication Foundation (WCF), the normal property that controls the creation of InstanceContext objects (the ServiceBehaviorAttribute.InstanceContextMode property) is no longer checked and has no effect.

Un meccanismo più generico con il quale è possibile inizializzare oggetti InstanceContext al momento della creazione (ad esempio, per allegare estensioni personalizzate a ogni InstanceContext) è rappresentato da System.ServiceModel.Dispatcher.IInstanceContextInitializer.A more generic mechanism by which you can initialize InstanceContext objects when created (for example, to attach custom extensions to each InstanceContext) is the System.ServiceModel.Dispatcher.IInstanceContextInitializer.

Metodi

GetExistingInstanceContext(Message, IContextChannel)

Metodo chiamato quando viene ricevuto un nuovo messaggio.Called when a new message is received.

InitializeInstanceContext(InstanceContext, Message, IContextChannel)

Questo metodo viene chiamato quando viene restituito null dal metodo GetExistingInstanceContext(Message, IContextChannel).Called when null is returned from the GetExistingInstanceContext(Message, IContextChannel) method.

IsIdle(InstanceContext)

Questo metodo viene chiamato quando tutte le attività InstanceContext sono state completate per consentire agli implementatori di impedire il riciclo di InstanceContext.Called when all InstanceContext activities have completed to enable implementers to prevent the InstanceContext from being recycled.

NotifyIdle(InstanceContextIdleCallback, InstanceContext)

Metodo chiamato quando il metodo IsIdle(InstanceContext) restituisce false per consentire agli implementatori di fornire un callback per notificare a WCF quando l'oggetto InstanceContext è stato completato.Called when the IsIdle(InstanceContext) method returns false to enable implementers to provide a callback to notify WCF when the InstanceContext object is finished.

Si applica a