ServiceThrottlingBehavior.MaxConcurrentInstances Proprietà

Definizione

Spazio dei nomi:

System.ServiceModel.Description

Assembly:

System.ServiceModel.dll

Ottiene o imposta un valore che specifica il numero massimo di oggetti InstanceContext del servizio che possono essere eseguiti contemporaneamente.

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

Valore della proprietà

Int32

Il numero massimo di oggetti InstanceContext presenti contemporaneamente nel servizio. Il valore predefinito è la somma del valore di MaxConcurrentSessions e il valore di MaxConcurrentCalls.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la classe ServiceThrottlingBehavior da un file di configurazione dell'applicazione che imposta le proprietà MaxConcurrentSessions, MaxConcurrentCalls e MaxConcurrentInstances su 1 a scopo di esempio. L'esperienza in scenari reali determina le impostazioni ottimali per qualsiasi applicazione specifica.

<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>

Commenti

La proprietà MaxConcurrentInstances specifica il numero massimo di oggetti InstanceContext nel servizio. È importante tenere presente la relazione tra la proprietà MaxConcurrentInstances e la proprietà InstanceContextMode. Se InstanceContextMode è PerSession, il valore risultante è il numero complessivo di sessioni. Se InstanceContextMode è PerCall il valore risultante è il numero di chiamate simultanee. Se un messaggio arriva quando il numero massimo di oggetti InstanceContext è già stato impostato, il messaggio viene messo in attesa fino a che un oggetto InstanceContext viene chiuso.

È anche possibile impostare i valori di questo attributo usando l'elemento <serviceThrottling> in un file di configurazione dell'applicazione.