ServiceThrottle.MaxConcurrentInstances Propriedade

Definição

Obtém ou define o número máximo de objetos de serviço que podem ser executados de cada vez.Gets or sets the maximum number of service objects that can execute at one time.

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

Valor da propriedade

O número máximo de objetos InstanceContext no serviço simultaneamente.The maximum number of InstanceContext objects in the service at one time. O padrão é máximo de chamadas simultâneas + máximo de sessões simultâneas.The default is Maximum Concurrent Calls + Maximum Concurrent Sessions.

Exemplos

O exemplo de código a seguir mostra o uso típico ServiceThrottle do referenciando ServiceThrottlingBehavior o em um arquivo de configuração de aplicativo.The following code example shows the typical use of the ServiceThrottle by referencing the ServiceThrottlingBehavior in an application configuration file. Nesse caso, os valores especificados estabelecem, no máximo, um processamento de mensagem de uma só vez de uma conexão com um InstanceContext.In this case, the values that are specified establish, at most, one message processing at one time from one connection to one InstanceContext. O uso do mundo real deve ser determinado por meio da experiência.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>

Comentários

A MaxConcurrentInstances propriedade especifica o número máximo de InstanceContext objetos no serviço.The MaxConcurrentInstances property specifies the maximum number of InstanceContext objects in the service. É importante ter em mente a relação entre a MaxConcurrentInstances Propriedade e a InstanceContextMode propriedade.It is important to keep in mind the relationship between the MaxConcurrentInstances property and the InstanceContextMode property. Se InstanceContextMode éPerSession o valor resultante é o número total de sessões.If InstanceContextMode is PerSession the resulting value is the total number of sessions. Se InstanceContextMode forPerCall, o valor resultante será o número de chamadas simultâneas.If InstanceContextMode is PerCall, the resulting value is the number of concurrent calls. Se uma mensagem chegar enquanto o número máximo de InstanceContext objetos já existir, a mensagem será mantida até que InstanceContext um objeto seja fechado.If a message arrives while the maximum number of InstanceContext objects already exist, the message is held until an InstanceContext object closes.

Observação

Um rastreamento é gravado toda vez que o valor dessa propriedade é excedido.A trace is written every time the value of this property is exceeded. O primeiro rastreamento é gravado como um aviso.The first trace is written as a warning.

Aplica-se a