<netPeerTcpBinding>

Article
09/12/2008

Définit une liaison pour la messagerie TCP spécifique au canal homologue.

<system.serviceModel>
<bindings>
<netPeerTcpBinding>

<netPeerBinding>
    <binding name="string"
         closeTimeout="TimeSpan"
         openTimeout="TimeSpan" 
         receiveTimeout="TimeSpan"
         sendTimeout="TimeSpan"
         listenIPAddress="String"
          maxBufferPoolSize="integer"
         maxReceiveMessageSize="Integer" 
         port="Integer"
         <security mode="None/Transport/Message/TransportWithMessageCredential">
            <transport credentialType="Certificate/Password" />
        </security>
    </binding>
</netPeerBinding>

Attributs et éléments

Attributs

Attribut	Description
closeTimeout	Valeur TimeSpan qui spécifie l'intervalle de temps prévu pour qu'une opération de fermeture s'effectue. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
listenIPAddress	Chaîne qui spécifie une adresse IP sur laquelle le nœud d'homologues écoutera les messages TCP. La valeur par défaut est null.
maxBufferPoolSize	Entier qui spécifie la taille maximale du pool de mémoires tampons pour cette liaison. La valeur par défaut est 524 288 octets (512 x 1024). De nombreuses parties de Windows Communication Foundation (WCF) utilisent des mémoires tampons. La création et la destruction des mémoires tampons à chaque utilisation sont chères, tout comme leur nettoyage. Avec les pools de mémoires tampons, vous pouvez prendre une mémoire tampon du pool, l'utiliser et la renvoyer dans le pool une fois que vous avez terminé. Ainsi, la surcharge de la création et de la destruction des mémoires tampons est évitée.
maxReceivedMessageSize	Entier positif qui spécifie la taille maximale du message, en octets, y compris les en-têtes, pouvant être reçu sur un canal configuré avec cette liaison. L'expéditeur d'un message qui dépasse cette limite se verra notifier une erreur SOAP. Le récepteur abandonne le message et crée une entrée d'événement dans le journal de suivi. La valeur par défaut est 65 536.
name	Chaîne qui contient le nom de configuration de la liaison. Cette valeur doit être unique car elle permet d'identifier la liaison.
openTimeout	Valeur TimeSpan qui spécifie l'intervalle de temps prévu pour qu'une opération d'ouverture s'effectue. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
port	Entier qui spécifie le port d'interface réseau sur lequel cette liaison traitera des messages TCP du canal homologue. Cette valeur doit être comprise entre MinPort et MaxPort. La valeur par défaut est 0.
receiveTimeout	Valeur TimeSpan qui spécifie l'intervalle de temps prévu pour qu'une opération de réception s'effectue. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:10:00.
sendTimeout	Valeur TimeSpan qui spécifie l'intervalle de temps prévu pour qu'une opération d'envoi s'effectue. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.

Éléments enfants

Élément	Description
<readerQuotas>	Définit les contraintes de la complexité des messages SOAP qui peuvent être traités par les points de terminaison configurés avec cette liaison. Cet élément est de type XmlDictionaryReaderQuotasElement.
<resolver>	Spécifie un programme de résolution d'homologue utilisé par cette liaison pour résoudre un ID de maille d'homologues en adresses IP de point de terminaison de nœuds dans la maille d'homologues.
<security> de <netPeerBinding>	Définit les paramètres de sécurité pour le message. Cet élément est de type PeerSecurityElement.

Éléments parents

Élément	Description
<bindings>	Cet élément conserve une collection de liaisons standard et personnalisées. Chaque entrée est identifiée par son name. Les services utilisent les liaisons en les liant à l'aide du name.

Notes

Cette liaison assure la prise en charge de la création d'applications d'égal à égal ou entre plusieurs parties utilisant le transport d'homologue sur TCP. Chaque nœud homologue peut héberger plusieurs canaux homologues définis avec ce type de liaison.

Exemple

L'exemple suivant montre l'utilisation de la liaison NetPeerTcpBinding, qui fournit la communication pluripartite à l'aide d'un canal homologue. Pour un scénario détaillé de l'utilisation de cette liaison, consultez Net Peer TCP.

<configuration>
<system.ServiceModel>
<bindings>
<netPeerBinding>
    <binding name="test"
         closeTimeout="00:00:10"
         openTimeout="00:00:20" 
         receiveTimeout="00:00:30"
         sendTimeout="00:00:40"
         maxBufferSize="1001"
         maxConnections="123" 
         maxReceiveMessageSize="1000">
        <reliableSession ordered="false"
            inactivityTimeout="00:02:00"
            enabled="true" />
        <security mode="TransportWithMessageCredential">
            <message clientCredentialType="CardSpace" />
        </security>
    </binding>
</netPeerBinding>
</bindings>
</system.ServiceModel>
</configuration>

Voir aussi

Référence

NetPeerTcpBinding
NetPeerTcpBindingElement

Concepts

Autres ressources

Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients
Net Peer TCP
Peer-to-Peer Networking

Partager via