Compartir a través de


<<netPeerTcpBinding>>

Define un enlace para la mensajería TCP concreta de canales del mismo nivel.

Jerarquía del esquema

<<system.serviceModel>>
  <enlaces>
    <<netPeerTcpBinding>>

Sintaxis

<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>

Atributos y elementos

En las siguientes secciones se describen atributos, elementos secundarios y elementos primarios

Atributos

Atributo Descripción

closeTimeout

Un valor TimeSpan que especifica el intervalo de tiempo del que dispone una operación de cierre para completarse. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00.

listenIPAddress

Una cadena que especifica una dirección IP en la que el nodo entre pares realizará escuchas para los mensajes del TCP. El valor predeterminado es null.

maxBufferPoolSize

Entero que especifica el tamaño máximo del grupo de búferes para este enlace. El valor predeterminado es 524.288 bytes (512x1024). En muchas partes de Windows Communication Foundation (WCF) se utilizan búferes. Crear y destruir búferes cada vez que se usan es caro, y la recolección de elementos no utilizados para los búferes también es cara. Con grupos de búferes, puede tomar un búfer del grupo, usarlo y devolverlo al grupo una vez haya terminado. Así se evitan los gastos generales al crear y destruir búferes.

maxReceivedMessageSize

Entero positivo que especifica el tamaño máximo del mensaje, en bytes, incluidos los encabezados, que se puede recibir en un canal configurado con este enlace. El remitente de un mensaje que supere este límite recibirá un error SOAP. El receptor quita el mensaje y crea una entrada del evento en el registro de seguimiento. El valor predeterminado es 65536.

name

Cadena que contiene el nombre de la configuración del enlace. Este valor debe ser único porque se usa como identificación del enlace. A partir de .NET Framework 4, no es necesario que los enlaces y los comportamientos tengan nombre. Para obtener más información sobre la configuración predeterminada, así como sobre enlaces y comportamientos sin nombre, vea Simplified Configuration y Simplified Configuration for WCF Services.

openTimeout

Valor de la estructura TimeSpan que especifica el intervalo de tiempo del que dispone una operación de apertura para completarse. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00.

port

Un entero que especifica el puerto de la interfaz de red en el que este enlace procesará los mensajes de TCP de canal del mismo nivel. Dicho valor debe encontrarse entre MinPort y MaxPort. El valor predeterminado es 0.

receiveTimeout

Un valor TimeSpan que especifica el intervalo de tiempo del que dispone una operación de recepción para completarse. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:10:00.

sendTimeout

Un valor TimeSpan que especifica el intervalo de tiempo del que dispone una operación de envío para completarse. Este valor debe ser mayor o igual que Zero. El valor predeterminado es 00:01:00.

Elementos secundarios

Elemento Descripción

<readerQuotas>

Define restricciones en la complejidad de los mensajes SOAP que pueden ser procesados por los extremos configurados con este enlace. Este elemento es del tipo XmlDictionaryReaderQuotasElement.

<resolver>

Especifica una resolución del mismo nivel utilizada por este enlace para resolver un Id. de la malla del mismo nivel a las direcciones IP de extremos de nodos dentro de la malla del mismo nivel.

Elemento <security> de <netPeerBinding>

Define la configuración de seguridad del mensaje. Este elemento es del tipo PeerSecurityElement.

Elementos primarios

Elemento Descripción

<enlaces>

Este elemento contiene una colección de enlaces estándar y personalizados.

Notas

Este enlace proporciona compatibilidad para la creación de aplicaciones punto a punto o de múltiples usuarios usando el transporte del mismo nivel a través de TCP. Cada nodo del mismo nivel puede hospedar múltiples canales del mismo nivel definidos con este tipo de enlace.

Ejemplo

El ejemplo siguiente muestra cómo utilizar el enlace NetPeerTcpBinding, que proporciona comunicación multipartidaria mediante un canal del mismo nivel. Para un escenario detallado sobre la utilización de este enlace, vea 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>

Vea también

Referencia

NetPeerTcpBinding
NetPeerTcpBindingElement

Conceptos

<binding>

Otros recursos

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