ServiceThrottlingBehavior.MaxConcurrentSessions 属性

定义

命名空间:

System.ServiceModel.Description

程序集:

System.ServiceModel.dll

获取或设置一个指定 ServiceHost 对象可一次接受的最大会话数的值。

public:
 property int MaxConcurrentSessions { int get(); void set(int value); };

public int MaxConcurrentSessions { get; set; }

member this.MaxConcurrentSessions : int with get, set

Public Property MaxConcurrentSessions As Integer

属性值

Int32

服务主机可接受的最大会话数。 默认值为处理器计数的 100 倍。

示例

下面的代码示例演示如何从配置文件中使用 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>

注解

MaxConcurrentSessions 属性指定一个 ServiceHost 对象可接受的最多会话数。 在此情况下，会话并不仅仅意味着支持可靠会话的信道（例如，System.ServiceModel.NetNamedPipeBinding 支持会话，但不包括可靠会话），理解这一点很重要。

每个侦听器对象可以有一个挂起的通道会话，在 WCF 接受通道会话并开始处理消息之前，该会话不会计入其值 MaxConcurrentSessions 。 在使用会话的方案中，此属性是最有用的。

如果将此属性设置为一个小于客户端线程数的值，则来自多个客户端的请求可能会在同一套接字连接中进行排队。 如果服务上打开的会话数已达到 MaxConcurrentSessions，则会阻止来自尚未与该服务建立会话的客户端的请求，直到该服务关闭其与其他客户端的会话。 未被提供服务的客户端请求会超时，而且服务会突然关闭会话。

若要避免这种情况，请从其他应用程序域中运行客户端线程，这样，请求消息就可进入其他套接字连接。

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