InstanceContextMode InstanceContextMode InstanceContextMode InstanceContextMode Enum

Définition

Spécifie le nombre d'instances de service disponibles pour gérer les appels contenus dans les messages entrants.Specifies the number of service instances available for handling calls that are contained in incoming messages.

public enum class InstanceContextMode
public enum InstanceContextMode
type InstanceContextMode = 
Public Enum InstanceContextMode
Héritage
InstanceContextModeInstanceContextModeInstanceContextModeInstanceContextMode

Champs

PerCall PerCall PerCall PerCall 1

Un objet InstanceContext est créé avant et recyclé après chaque appel.A new InstanceContext object is created prior to and recycled subsequent to each call.

PerSession PerSession PerSession PerSession 0

Un objet InstanceContext est créé pour chaque session.A new InstanceContext object is created for each session. Si le canal ne crée pas de session, cette valeur se comporte comme si elle était PerCall.If the channel does not create a session this value behaves as if it were PerCall.

Single Single Single Single 2

Un seul objet InstanceContext est utilisé pour tous les appels entrants et il n'est pas recyclé après les appels.Only one InstanceContext object is used for all incoming calls and is not recycled subsequent to the calls. S'il n'existe aucun objet de service, le système en crée un.If a service object does not exist, one is created.

Exemples

L'exemple de code ci-dessous montre comment définir le InstanceContextMode pour une classe de service :The following code illustrates how to set the InstanceContextMode for a service class:

// Service class which implements the service contract.
[ServiceBehavior(InstanceContextMode=InstanceContextMode.PerSession)]
public class CalculatorService : ICalculator
{
    public double Add(double n1, double n2)
    {
        return n1 + n2;
    }

    public double Subtract(double n1, double n2)
    {
        return n1 - n2;
    }

    public double Multiply(double n1, double n2)
    {
        return n1 * n2;
    }

    public double Divide(double n1, double n2)
    {
        return n1 / n2;
    }
}
' Service class which implements the service contract.
Public Class CalculatorService
Implements ICalculator

    Public Function Add(n1 As Double, n2 As Double) As Double Implements ICalculator.Add
        Return n1 + n2
    End Function

    Public Function Subtract(n1 As Double, n2 As Double) As Double Implements ICalculator.Subtract
        Return n1 - n2
    End Function

    Public Function Multiply(n1 As Double, n2 As Double) As Double Implements ICalculator.Multiply
        Return n1 * n2
    End Function

    Public Function Divide(n1 As Double, n2 As Double) As Double Implements ICalculator.Divide
        Return n1 / n2
    End Function

End Class

Remarques

La System.ServiceModel.InstanceContext classe gère l’association entre le canal et les objets de service définis par l’utilisateur.The System.ServiceModel.InstanceContext class manages the association between the channel and the user-defined service objects. Utilisez l'énumération InstanceContextMode avec la propriété ServiceBehaviorAttribute.InstanceContextMode pour spécifier la durée de vie de l'objet InstanceContext.Use the InstanceContextMode enumeration with the ServiceBehaviorAttribute.InstanceContextMode property to specify the lifetime of the InstanceContext object. Windows Communication Foundation (WCF) peut créer un nouvel InstanceContext objet pour chaque appel, chaque session ou spécifier que l' InstanceContext objet est lié à un objet de service unique.Windows Communication Foundation (WCF) can create a new InstanceContext object for every call, every session, or specify that the InstanceContext object is bound to a single service object. Pour obtenir un exemple fonctionnel, consultez instanciation.For a working example, see Instancing.

La valeur Single spécifie qu'un objet InstanceContext unique doit être utilisé pendant toute la durée de vie du service.The Single value specifies that a single InstanceContext object should be used for the lifetime of the service. Plusieurs avertissements sont associés à la Single valeur:Several caveats are associated with the Single value:

S’applique à

Voir aussi