<tcpTransport>

Article
07/03/2007

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

<system.serviceModel>

                                    
                                    <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 https://www.microsoft.com/technet/prodtechnol/winxppro/maintain/teredo.mspx. This property is only applicable 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 https://www.microsoft.com/technet/prodtechnol/winxppro/maintain/teredo.mspx. For more information, see https://www.microsoft.com/windowsserver2003/technologies/ipv6/default.mspx.

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 https://www.microsoft.com/technet/prodtechnol/winxppro/maintain/teredo.mspx.

This property is only applicable 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 https://www.microsoft.com/technet/prodtechnol/winxppro/maintain/teredo.mspx. For more information, see https://www.microsoft.com/windowsserver2003/technologies/ipv6/default.mspx.

Child Elements

None

Parent Elements

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

<tcpTransport>

Attributes and Elements

Attributes

Child Elements

Parent Elements

See Also

Reference

Additional resources