<connectionLimit> Element

Article
09/13/2006

Specifies the maximum number of connections made to and from an application that sends and/or receives SOAP messages using the TCP protocol.

<microsoft.web.services3> Element
  <messaging> Element
    <transports> Element
      <add> Element for <transports>

<connectionLimit inbound outbound />

Attributes and Elements

Attributes

Attribute	Description
inbound	Required attribute. Specifies the maximum number of incoming TCP connections to an application. A value of -1 specifies that there is no limit. The default value is 16.
outbound	Required attribute. Specifies the maximum number of outgoing TCP connections from an application. A value of -1 specifies that there is no limit. The default value is 16.

Child Elements

None

Parent Elements

Element	Description
<add> Element for <transports>	Adds a SOAP transport to the system.

Remarks

The <connectionLimit> element applies to an application, which may contain one or more listeners or Web services and does not apply to TCP connections made to the same computer hosting the application. The number of local TCP connections is unrestricted.

When the maximum number of outgoing or incoming TCP connections is exceeded, a System.InvalidOperationException is thrown to the application and for incoming SOAP messages WSE generates an event log on the receiving computer.

Before adding the <connectionLimit> element to a configuration file, you must add the microsoft.web.services3 configuration section handler to the configuration file. For details about adding the microsoft.web.services3 configuration section handler, see <section> Element.

Example

The following code example specifies that the maximum number of incoming and outgoing TCP connections is 10.

<configuration>
  <microsoft.web.services3>
    <messaging>
      <transports>
        <add scheme="soap.tcp">
          <connectionLimit
            inbound="10"
            outbound="10"/>
        </add>
      </transports>
    </messaging>
  </microsoft.web.services3>
</configuration>

Share via