IInstanceContextProvider IInstanceContextProvider IInstanceContextProvider IInstanceContextProvider Interface

Définition

Implémentez pour participer à la création ou à la sélection d'un objet InstanceContext, en particulier pour activer des sessions partagées.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

Remarques

Implémentez l'interface IInstanceContextProvider pour fournir l'objet System.ServiceModel.InstanceContext approprié au système.Implement the IInstanceContextProvider interface to provide the appropriate System.ServiceModel.InstanceContext object to the system. En général, cette interface est implémentée pour prendre en charge les sessions partagées, activer le regroupement d'instances de service, contrôler les durées de vie d'instances de service ou regrouper des contextes parmi des clients.Typically, this interface is implemented to support shared sessions, enable service instance pooling, control lifetimes of service instances, or to group contexts among clients.

Par exemple, pour implémenter le partage, insérez un IInstanceContextProvider personnalisé pour décider quelle session ou appel d'un client est associé à quel objet 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. Pour obtenir un exemple qui illustre le partage de contextes d’instance, consultez InstanceContextSharing.For an example that demonstrates the sharing of instance contexts, see InstanceContextSharing.

Notes

Lorsqu’un IInstanceContextProvider est inséré dans Windows Communication Foundation (WCF), la propriété normale qui contrôle la création d' InstanceContext objets (la ServiceBehaviorAttribute.InstanceContextMode propriété) n’est plus vérifiée et n’a aucun effet.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 mécanisme plus générique grâce auquel vous pouvez initialiser des objets InstanceContext une fois créés (par exemple, pour attacher des extensions personnalisées à chaque InstanceContext) est 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.

Méthodes

GetExistingInstanceContext(Message, IContextChannel) GetExistingInstanceContext(Message, IContextChannel) GetExistingInstanceContext(Message, IContextChannel) GetExistingInstanceContext(Message, IContextChannel)

Appelé à la réception d'un nouveau message.Called when a new message is received.

InitializeInstanceContext(InstanceContext, Message, IContextChannel) InitializeInstanceContext(InstanceContext, Message, IContextChannel) InitializeInstanceContext(InstanceContext, Message, IContextChannel) InitializeInstanceContext(InstanceContext, Message, IContextChannel)

Appelée lorsque la valeur null est retournée par la méthode GetExistingInstanceContext(Message, IContextChannel).Called when null is returned from the GetExistingInstanceContext(Message, IContextChannel) method.

IsIdle(InstanceContext) IsIdle(InstanceContext) IsIdle(InstanceContext) IsIdle(InstanceContext)

Appelée lorsque toutes les activités InstanceContext sont terminées pour permettre aux implémenteurs d'empêcher le InstanceContext d'être recyclé.Called when all InstanceContext activities have completed to enable implementers to prevent the InstanceContext from being recycled.

NotifyIdle(InstanceContextIdleCallback, InstanceContext) NotifyIdle(InstanceContextIdleCallback, InstanceContext) NotifyIdle(InstanceContextIdleCallback, InstanceContext) NotifyIdle(InstanceContextIdleCallback, InstanceContext)

Appelée lorsque la méthode IsIdle(InstanceContext) retourne false pour permettre aux implémenteurs de fournir un rappel pour notifier WCF lorsque l’objet InstanceContext est terminé.Called when the IsIdle(InstanceContext) method returns false to enable implementers to provide a callback to notify WCF when the InstanceContext object is finished.

S’applique à