<tcpTransport>

Artigo
01/05/2010

Defines a TCP transport that can be used by a channel to transfers messages for a custom binding.

Schema Hierarchy

<system.serviceModel>
  <bindings>
    <customBinding>
      <binding>
        <tcpTransport>

Syntax

<tcpTransport 
    listenBacklog="Integer"
        portSharingEnabled="Boolean"
    teredoEnabled="Boolean"
    transferMode=”Buffered/Streamed”
        <connectionPoolSettings
          groupName=”String”
        idleTimeout"TimeSpan"
        leaseTimeout="TimeSpan"
        maxOutboundConnectionsPerEndpopint=”Integer” />
/>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
listenBacklog	A positive integer that specifies the maximum number of channels that are waiting on the listener to be accepted. Connections in excess of the limit are queued until a space below the limit becomes available. The connectionLeaseTimeout attribute limits the duration the client will wait to be connected before throwing a connection exception. The default is 10.
portSharingEnabled	A Boolean value that specifies if TCP port sharing is enabled for this connection. If this is false, each binding will use its own exclusive port. The default is false. This setting is relevant only to services. Clients are not affected. Using this setting requires enabling the Windows Communication Foundation (WCF) TCP Port Sharing Service by changing its Startup Type to Manual or Automatic
teredoEnabled	A Boolean value that specifies whether Teredo (a technology for addressing clients that are behind firewalls) is enabled. The default is false. This property enables Teredo for the underlying TCP socket. For more information, see Teredo Overview. This property is applicable only on Windows XP SP2 and Windows Server 2003. Windows Vista has a machine-wide configuration option for Teredo, so when running Vista, this property is ignored. Teredo requires that the client and service machines both have the Microsoft IPv6 stack installed and correctly configured for Teredo usage. For more information about configuring Teredo, see Teredo Overview. For more information, see Windows Server 2003 Technology Centers.

listenBacklog

A positive integer that specifies the maximum number of channels that are waiting on the listener to be accepted. Connections in excess of the limit are queued until a space below the limit becomes available. The connectionLeaseTimeout attribute limits the duration the client will wait to be connected before throwing a connection exception. The default is 10.

portSharingEnabled

A Boolean value that specifies if TCP port sharing is enabled for this connection. If this is false, each binding will use its own exclusive port. The default is false.

This setting is relevant only to services. Clients are not affected.

Using this setting requires enabling the Windows Communication Foundation (WCF) TCP Port Sharing Service by changing its Startup Type to Manual or Automatic

teredoEnabled

A Boolean value that specifies whether Teredo (a technology for addressing clients that are behind firewalls) is enabled. The default is false.

This property enables Teredo for the underlying TCP socket. For more information, see Teredo Overview.

This property is applicable only on Windows XP SP2 and Windows Server 2003. Windows Vista has a machine-wide configuration option for Teredo, so when running Vista, this property is ignored. Teredo requires that the client and service machines both have the Microsoft IPv6 stack installed and correctly configured for Teredo usage. For more information about configuring Teredo, see Teredo Overview. For more information, see Windows Server 2003 Technology Centers.

Child Elements

None

Parent Elements

Element	Description
<binding>	Defines all binding capabilities of the custom binding.

Remarks

This transport uses URIs of the form "net.tcp://hostname:port/path". Other URI components are optional.

The tcpTransport element is the starting point for creating a custom binding that implements the TCP transport protocol. This transport is optimized for WCF-to-WCF communication.

Partilhar via

<tcpTransport>

Schema Hierarchy

Syntax

Attributes and Elements

Attributes

Child Elements

Parent Elements

Remarks

See Also

Reference

Other Resources

Recursos adicionais