ServiceThrottle.MaxConcurrentInstances 屬性

定義

命名空間:

System.ServiceModel.Dispatcher

組件:

System.ServiceModel.dll

取得或設定可以同時執行服務物件的數目上限。

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 用法。 在此情況下，所指定的值一次最多會建立一個訊息處理 (從一個連線到一個 InstanceContext)。 實際用法必須取決於經驗。

<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 屬性之間的關聯性。 如果 InstanceContextMode 是 PerSession 產生的值，則為會話總數。 如果 InstanceContextMode 是 PerCall，則產生的值是同時呼叫的數目。 如果訊息在已有最大數目的 InstanceContext 物件存在時抵達，則會保留該訊息，直到 InstanceContext 物件關閉為止。

注意

每當超過這個屬性值時，就會寫入至追蹤。 第一個追蹤會寫入成為警告。