Partager via

<netPeerTcpBinding>

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

<Configuration>
   <system.serviceModel>
     <Liaisons>
       <netPeerTcpBinding>

Syntaxe

<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

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

Attributes

Caractéristique Descriptif
closeTimeout Valeur TimeSpan qui spécifie l’intervalle de temps fourni pour qu’une opération de fermeture se termine. 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 homologue écoute 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 * 1024). De nombreuses parties de Windows Communication Foundation (WCF) utilisent des mémoires tampons. La création et la destruction de mémoires tampons chaque fois qu’elles sont utilisées est coûteuse et le garbage collection pour les mémoires tampons est également coûteux. Avec les pools de mémoires tampons, vous pouvez prendre une mémoire tampon à partir du pool, l’utiliser et la retourner au pool une fois que vous avez terminé. Ainsi, la surcharge dans la création et la destruction de 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, qui peuvent être reçus sur un canal configuré avec cette liaison. L’expéditeur d’un message dépassant cette limite reçoit une erreur SOAP. Le destinataire supprime le message et crée une entrée de l’événement dans le journal des traces. La valeur par défaut est 65536.
nom Chaîne qui contient le nom de configuration de la liaison. Cette valeur doit être unique, car elle est utilisée comme identification pour la liaison. À compter de .NET Framework 4, les liaisons et les comportements ne sont pas nécessaires pour avoir un nom. Pour plus d’informations sur la configuration par défaut et les liaisons sans nom et les comportements, consultez Configuration simplifiée et Configuration simplifiée pour les services WCF.
openTimeout Valeur TimeSpan qui spécifie l’intervalle de temps fourni pour qu’une opération ouverte se termine. 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 traite les 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 fourni pour qu’une opération de réception se termine. 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 fourni pour qu’une opération d’envoi se termine. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.

Éléments enfants

Élément Descriptif
<readerQuotas> Définit les contraintes relatives à 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.
<Résolveur> Spécifie un programme de résolution d’homologue utilisé par cette liaison pour résoudre un ID de maillage homologue vers les adresses IP de point de terminaison des nœuds au sein du maillage homologue.
<sécurité> Définit les paramètres de sécurité du message. Cet élément est de type PeerSecurityElement.

Éléments parents

Élément Descriptif
<Liaisons> Cet élément contient une collection de liaisons standard et personnalisées.

Remarques

Cette liaison prend en charge la création d’applications peer-to-peer ou multiparty à l’aide du transport homologue via TCP. Chaque nœud homologue peut héberger plusieurs canaux homologues définis avec ce type de liaison.

Example

L’exemple suivant illustre l’utilisation de la liaison NetPeerTcpBinding, qui fournit une communication multipartie à l’aide d’un canal homologue. Pour obtenir un scénario détaillé d’utilisation de cette liaison, consultez Net Peer TCP.

<configuration>
  <system.ServiceModel>
    <bindings>
      <netPeerBinding>
        <binding 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

  • Last updated on