ServiceThrottle.MaxConcurrentSessions Свойство

Определение

Возвращает или устанавливает значение, которое определяет максимальное количество сеансов, которые может принимать объект ServiceHost одновременно.Gets or sets a value that specifies the maximum number of sessions a ServiceHost object can accept at one time.

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

Значение свойства

Максимальное количество сеансов, принимаемых узлом службы.The maximum number of sessions a service host accepts. Значение по умолчанию — 100 * число процессоров на компьютере.The default is 100 * number of processors in the computer.

Примеры

В следующем примере кода демонстрируется типовое использование объекта ServiceThrottle путем указания поведения ServiceThrottlingBehavior в файле конфигурации приложения.The following code example shows the typical use of the ServiceThrottle by referencing the ServiceThrottlingBehavior in an application configuration file. В данном случае указанные значения обеспечивают обработку не более одного сообщения одновременно от одного подключения к одному объекту InstanceContext.In this case, the values that are specified establish, at most, one message processing at one time from one connection to one InstanceContext. Реальное использование определяется фактическими условиями.Real-world usage must be determined through experience.

<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.The MaxConcurrentSessions property specifies the maximum number of channels a ServiceHost can accept. Каждый объект прослушивателя может иметь один ожидающий канал, который не учитывает значение MaxConcurrentSessions до тех пор, пока WCF не примет канал и не начнет обрабатывать на нем сообщения.Each listener object can have one pending channel that does not count against the value of MaxConcurrentSessions until WCF accepts the channel and begins processing messages on it. Это свойство особенно полезно в сценариях, где используются сеансы.This property is most useful in scenarios that make use of sessions.

Примечание

Каждый раз при превышении значения этого свойства происходит запись трассировки.A trace is written every time the value of this property is exceeded. Первая трассировка записывается как предупреждение.The first trace is written as a warning.

Дополнительные сведения о сеансах см. в разделе Использование сеансов.For more information about sessions, see Using Sessions.

Обычно для задания этого свойства используется свойство ServiceThrottlingBehavior.MaxConcurrentSessions.Typically, this property is set using the ServiceThrottlingBehavior.MaxConcurrentSessions property.

Применяется к