Partager via

<tcpTransport>

Définit un transport TCP qui peut être utilisé par un canal pour transférer des messages pour une liaison personnalisée.

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

Syntaxe

<tcpTransport channelInitializationTimeout="TimeSpan"
              connectionBufferSize="Integer"
              hostNameComparisonMode="StrongWildcard/Exact/WeakWildcard"
              listenBacklog="Integer"
              manualAddressing="Boolean"
              maxBufferPoolSize="Integer"
              maxBufferSize="Integer"
              maxOutputDelay="TimeSpan"
              maxPendingAccepts="Integer"
              maxPendingConnections="Integer"
              maxReceivedMessageSize="Integer"
              portSharingEnabled="Boolean"
              teredoEnabled="Boolean"
              transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse" >
  <connectionPoolSettings groupName="String"
                          idleTimeout="TimeSpan"
                          leaseTimeout="TimeSpan"
                          maxOutboundConnectionsPerEndpoint="Integer" />
</tcpTransport>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributes

Caractéristique Descriptif
channelInitializationTimeout Obtient ou définit la limite de temps pour l’initialisation d’un canal à accepter. Durée maximale pendant laquelle un canal peut être dans l’état d’initialisation avant d’être déconnecté en secondes. Ce quota inclut le temps nécessaire à une connexion TCP pour s’authentifier à l’aide du protocole .NET Message Framework. Un client doit envoyer des données initiales avant que le serveur dispose de suffisamment d’informations pour effectuer l’authentification. La valeur par défaut est de 30 secondes.
connectionBufferSize Obtient ou définit la taille de la mémoire tampon utilisée pour transmettre un bloc du message sérialisé sur le câble à partir du client ou du service.
hostNameComparisonMode Obtient ou définit une valeur qui indique si le nom d’hôte est utilisé pour atteindre le service lors de la correspondance sur l’URI.
listenBacklog Nombre maximal de demandes de connexion en file d’attente pouvant être en attente pour un service Web. L’attribut connectionLeaseTimeout limite la durée pendant laquelle le client attendra d’être connecté avant de lever une exception de connexion. Il s’agit d’une propriété au niveau du socket qui contrôle le nombre maximal de demandes de connexion en file d’attente pouvant être en attente pour un service Web. Lorsque ListenBacklog est trop faible, WCF cesse d’accepter les demandes et supprime donc de nouvelles connexions jusqu’à ce que le serveur reconnaisse certaines des connexions mises en file d’attente existantes. La valeur par défaut est 16 * nombre de processeurs.
manualAddressing Obtient ou définit une valeur qui indique si l’adressage manuel du message est requis.
maxBufferPoolSize Obtient ou définit la taille maximale des pools de mémoires tampons utilisés par le transport.
maxBufferSize Obtient ou définit la taille maximale de la mémoire tampon à utiliser. Pour les messages diffusés en continu, cette valeur doit être au moins la taille maximale possible des en-têtes de message, qui sont lus en mode mis en mémoire tampon.
maxOutputDelay Obtient ou définit l’intervalle maximal de temps pendant lequel un segment d’un message ou un message complet peut rester mis en mémoire tampon avant d’être envoyé.
maxPendingAccepts Obtient ou définit le nombre maximal d’opérations d’acceptation asynchrones en attente disponibles pour le traitement des connexions entrantes au service.
maxPendingConnections Obtient ou définit le nombre maximal de connexions en attente de répartition sur le service.
maxReceivedMessageSize Obtient et définit la taille maximale autorisée des messages pouvant être reçus.
portSharingEnabled Valeur booléenne qui spécifie si le partage de ports TCP est activé pour cette connexion. Si c’est falsele cas, chaque liaison utilise son propre port exclusif. La valeur par défaut est false.

Ce paramètre est pertinent uniquement pour les services. Les clients ne sont pas affectés.

L’utilisation de ce paramètre nécessite l’activation du service de partage de ports TCP Windows Communication Foundation (WCF) en modifiant son type de démarrage en manuel ou automatique
teredoEnabled Valeur booléenne qui spécifie si Teredo (technologie permettant d’adresser les clients derrière des pare-feu) est activée. La valeur par défaut est false.

Cette propriété active Teredo pour le socket TCP sous-jacent. Pour plus d’informations, consultez Vue d’ensemble de Teredo.

Cette propriété s’applique uniquement sur Windows XP SP2 et Windows Server 2003. Windows Vista dispose d’une option de configuration à l’échelle de l’ordinateur pour Teredo. Par conséquent, lors de l’exécution de Vista, cette propriété est ignorée. Teredo nécessite que les machines clientes et de service disposent toutes deux de la pile Microsoft IPv6 installée et correctement configurées pour l’utilisation de Teredo.
transferMode Obtient ou définit une valeur qui indique si les messages sont mis en mémoire tampon ou diffusées en continu avec le transport orienté connexion.
connectionPoolSettings Spécifie des paramètres de pool de connexions supplémentaires pour une liaison de canal nommé.

Éléments enfants

Aucun

Éléments parents

Élément Descriptif
<reliure> Définit toutes les fonctionnalités de liaison de la liaison personnalisée.

Remarques

Ce transport utilise des URI de la forme « net.tcp ://hostname :port/path ». D’autres composants d’URI sont facultatifs.

L’élément tcpTransport est le point de départ de la création d’une liaison personnalisée qui implémente le protocole de transport TCP. Ce transport est optimisé pour la communication WCF-à-WCF.

Voir aussi

  • Last updated on