ServiceThrottlingBehavior クラス

リファレンス

定義

名前空間:: System.ServiceModel.Description

アセンブリ:: System.ServiceModel.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

サービスパフォーマンスを調整できるようにするランタイムスループット設定を構成します。

public ref class ServiceThrottlingBehavior : System::ServiceModel::Description::IServiceBehavior

public class ServiceThrottlingBehavior : System.ServiceModel.Description.IServiceBehavior

type ServiceThrottlingBehavior = class
    interface IServiceBehavior

Public Class ServiceThrottlingBehavior
Implements IServiceBehavior

継承: Object
ServiceThrottlingBehavior

実装: IServiceBehavior

例

例として、ServiceThrottlingBehavior、MaxConcurrentSessions、および MaxConcurrentCalls の各プロパティを 1 に設定するアプリケーション構成ファイルから MaxConcurrentInstances を使用する方法を次のコード例に示します。特定のアプリケーションで最適な設定については、実際の動作から判断します。

<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>

注釈

ServiceThrottlingBehavior クラスを使用して、アプリケーションのメモリ不足を防ぐためのさまざまなスループット設定を制御します。

MaxConcurrentCalls プロパティは、ServiceHost で同時に処理できるメッセージの数を制限します。

MaxConcurrentInstances プロパティは、InstanceContext で同時に実行できる ServiceHost オブジェクトの数を制限します。

MaxConcurrentSessions プロパティは、ServiceHost オブジェクトが受け入れ可能なセッションの数を制限します。

実行時の負荷分散にはアプリケーションの実行エクスペリエンスが必要なため、サービスのパフォーマンスを最大化するために実行を変更する場合は、アプリケーション構成ファイルから ServiceThrottlingBehavior を使用する方法が最も一般的です。

注意

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

アプリケーション構成ファイルで serviceThrottling> 要素を<使用して、この属性の値を設定することもできます。

コンストラクター

ServiceThrottlingBehavior()

ServiceThrottlingBehavior クラスの新しいインスタンスを初期化します。

プロパティ

MaxConcurrentCalls	ServiceHost でアクティブに処理されるメッセージの最大数を指定する値を取得または設定します。
MaxConcurrentInstances	同時に実行できるサービス内の InstanceContext オブジェクトの最大数を指定する値を取得または設定します。
MaxConcurrentSessions	ServiceHost オブジェクトが同時に受け入れ可能なセッションの最大数を指定する値を取得または設定します。

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

明示的なインターフェイスの実装

IServiceBehavior.AddBindingParameters(ServiceDescription, ServiceHostBase, Collection<ServiceEndpoint>, BindingParameterCollection)	バインディングを、サービスの動作をサポートするように構成します。
IServiceBehavior.ApplyDispatchBehavior(ServiceDescription, ServiceHostBase)	サービスを、サービスの動作をサポートするように構成します。
IServiceBehavior.Validate(ServiceDescription, ServiceHostBase)	サービスおよびホストがサービスの動作をサポートできることを検証します。

適用対象

次の方法で共有