ServiceThrottle.MaxConcurrentInstances プロパティ

定義

一度に実行可能なサービス オブジェクトの最大数を取得または設定します。

public:
 property int MaxConcurrentInstances { int get(); void set(int value); };
public int MaxConcurrentInstances { get; set; }
member this.MaxConcurrentInstances : int with get, set
Public Property MaxConcurrentInstances As Integer

プロパティ値

Int32

任意の一時点におけるサービス内の InstanceContext オブジェクトの最大数。 既定では、同時呼び出しの最大数 + 同時セッションの最大数です。

次のコード例では、アプリケーション構成ファイル内の ServiceThrottle を参照することにより、ServiceThrottlingBehavior の典型的な使用方法を表示しています。 このケースでは、指定された値が、任意の一時点において 1 つの接続から 1 つの InstanceContext に対して確立するメッセージ処理は、多くとも 1 つです。 実際の使用方法は、経験を通して決定する必要があります。

<configuration>
  <appSettings>
    <!-- use appSetting to configure base address provided by host -->
    <add key="baseAddress" value="http://localhost:8080/ServiceMetadata" />
  </appSettings>
  <system.serviceModel>
    <services>
      <service 
        name="Microsoft.WCF.Documentation.SampleService"
        behaviorConfiguration="Throttled" >
        <host>
          <baseAddresses>
            <add baseAddress="http://localhost:8080/SampleService"/>
          </baseAddresses>
        </host>
        <endpoint
          address=""
          binding="wsHttpBinding"
          contract="Microsoft.WCF.Documentation.ISampleService"
         />
        <endpoint
          address="mex"
          binding="mexHttpBinding"
          contract="IMetadataExchange"
         />
      </service>
    </services>
    <behaviors>
      <serviceBehaviors>
        <behavior  name="Throttled">
          <serviceThrottling 
            maxConcurrentCalls="1" 
            maxConcurrentSessions="1" 
            maxConcurrentInstances="1"
          />
          <serviceMetadata 
            httpGetEnabled="true" 
            httpGetUrl=""
          />
        </behavior>
      </serviceBehaviors>
    </behaviors>
  </system.serviceModel>
</configuration>

注釈

MaxConcurrentInstances プロパティは、サービス内の InstanceContext オブジェクトの最大数を表します。 MaxConcurrentInstances プロパティおよび InstanceContextMode プロパティの間の関係を覚えておくことは重要です。 結果の値がPerSessionセッションの合計数である場合InstanceContextModeInstanceContextModePerCall の場合、得られる値は同時呼び出し数です。 InstanceContext オブジェクトの数が最大数に達しているときに受信したメッセージは、1 つの InstanceContext オブジェクトを閉じるまで保留されます。

注意

このプロパティの値を超えるたびにトレースが出力されます。 最初のトレースは警告として出力されます。

適用対象