ServiceThrottlingBehavior.MaxConcurrentInstances 属性

定义

命名空间:

System.ServiceModel.Description

程序集:

System.ServiceModel.dll

获取或设置一个值，该值指定服务中可以一次执行的最多 InstanceContext 对象数。

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 对象数。 默认值为值MaxConcurrentSessions和值之和 。MaxConcurrentCalls

示例

下面的代码示例演示如何从应用程序配置文件中使用 ServiceThrottlingBehavior，举例来说，它可将 MaxConcurrentSessions、MaxConcurrentCalls 和 MaxConcurrentInstances 属性设置为 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 属性之间的关系是很重要。 如果 InstanceContextMode 为 PerSession，则结果值将为总会话数。 如果 InstanceContextMode 为 PerCall，则结果值将为并发调用的数量。 如果消息到达时，InstanceContext 对象的数目已经达到最大数量，则将保存该消息，直至有 InstanceContext 对象关闭。

还可以通过在应用程序配置文件中使用 <serviceThrottling> 元素来设置此属性的值。