InstanceContextMode InstanceContextMode InstanceContextMode InstanceContextMode Enum

定義

入力メッセージに含まれている呼び出しを処理するために使用できるサービス インスタンスの数を指定します。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
継承
InstanceContextModeInstanceContextModeInstanceContextModeInstanceContextMode

フィールド

PerCall PerCall PerCall PerCall 1

それぞれの呼び出しの前に新しい InstanceContext オブジェクトを作成し、その後、そのオブジェクトをリサイクルします。A new InstanceContext object is created prior to and recycled subsequent to each call.

PerSession PerSession PerSession PerSession 0

セッションごとに新しい InstanceContext オブジェクトを作成します。A new InstanceContext object is created for each session. チャネルがセッションを作成しない場合、この値は、PerCall であるかのように動作します。If the channel does not create a session this value behaves as if it were PerCall.

Single Single Single Single 2

すべての着信呼び出しに対して 1 つの InstanceContext オブジェクトだけを使用し、その後、そのオブジェクトをリサイクルしません。Only one InstanceContext object is used for all incoming calls and is not recycled subsequent to the calls. サービス オブジェクトが存在しない場合は、1 つ作成されます。If a service object does not exist, one is created.

サービス クラスに対して InstanceContextMode を設定する方法を次のコード例に示します。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

注釈

System.ServiceModel.InstanceContext は、チャネルとユーザー定義サービス オブジェクトとの関連付けを管理します。The System.ServiceModel.InstanceContext manages the association between the channel and the user-defined service objects. InstanceContextMode プロパティを持つ ServiceBehaviorAttribute.InstanceContextMode 列挙型を使用して、InstanceContext オブジェクトの有効期間を指定します。Use the InstanceContextMode enumeration with the ServiceBehaviorAttribute.InstanceContextMode property to specify the lifetime of the InstanceContext object. Windows Communication Foundation (WCF) を新規に作成できますInstanceContextオブジェクトのすべてのセッションのすべての呼び出しのことも、InstanceContextオブジェクトが 1 つのサービス オブジェクトにバインドします。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. 実際の例を参照してください、 Instancingします。For a working example, see the Instancing.

1 つの値を指定する 1 つSingleオブジェクトは、サービスの有効期間のために使用する必要があります。The Single value specifies that a single Single object should be used for the lifetime of the service.

注意

場合、InstanceContextMode値が 1 つの結果、サービスできますのみ処理することが 1 つのメッセージはでも設定していない場合に設定されて、ConcurrencyMode値をMultipleします。If the InstanceContextMode value is set to Single the result is that your service can only process one message at a time unless you also set the ConcurrencyMode value to Multiple.

適用対象

こちらもご覧ください