InstanceContextMode Enumerazione
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Specifica il numero di istanze del servizio disponibili per la gestione delle chiamate contenute nei messaggi in ingresso.
public enum class InstanceContextModepublic enum InstanceContextModetype InstanceContextMode = Public Enum InstanceContextMode- Ereditarietà
Campi
| Nome | Valore | Descrizione |
|---|---|---|
| PerSession | 0 | Viene creato un nuovo InstanceContext oggetto per ogni sessione. Se il canale non crea una sessione, questo valore si comporta come se fosse PerCall. |
| PerCall | 1 | Un nuovo InstanceContext oggetto viene creato prima e riciclato successivamente a ogni chiamata. |
| Single | 2 | Per tutte le chiamate in ingresso viene usato un InstanceContext solo oggetto e non viene riciclato successivamente alle chiamate. Se non esiste un oggetto servizio, ne viene creato uno. |
Esempio
Il codice seguente illustra come impostare per InstanceContextMode una classe del servizio:
// 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
Commenti
La System.ServiceModel.InstanceContext classe gestisce l'associazione tra il canale e gli oggetti servizio definiti dall'utente. Utilizzare l'enumerazione InstanceContextMode con la ServiceBehaviorAttribute.InstanceContextMode proprietà per specificare la durata dell'oggetto InstanceContext . Windows Communication Foundation (WCF) può creare un nuovo InstanceContext oggetto per ogni chiamata, ogni sessione o specificare che l'oggetto InstanceContext è associato a un singolo oggetto servizio. Per un esempio funzionante, vedere Creazione di istanze.
Il Single valore specifica che un singolo InstanceContext oggetto deve essere utilizzato per la durata del servizio. Al valore sono associate Single diverse avvertenze:
Se il ServiceBehaviorAttribute.InstanceContextMode valore è impostato su
Single, il servizio può elaborare un solo messaggio alla volta, a meno che non si imposti anche il ConcurrencyMode valore su ConcurrencyMode.Multiple.Per il comportamento della durata singleton( ad esempio, se l'applicazione host chiama il ServiceHost.ServiceHost costruttore e passa un oggetto da usare come servizio), la classe del servizio deve impostare su ServiceBehaviorAttribute.InstanceContextMode
Singleo viene generata un'eccezione all'apertura dell'host del servizio.
