<netPeerTcpBinding>

项目
09/12/2008

为特定于对等通道的 TCP 消息定义绑定。

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

属性和元素

属性

属性	说明
closeTimeout	一个 TimeSpan 值，指定为完成关闭操作提供的时间间隔。此值应大于或等于 Zero。默认值为 00:01:00。
listenIPAddress	一个字符串，指定对等节点将在其上侦听 TCP 消息的 IP 地址。默认值为空。
maxBufferPoolSize	一个整数，指定此绑定的最大缓冲池大小。默认值为 524,288 字节 (512 * 1024)。Windows Communication Foundation (WCF) 的许多部件使用缓冲区。每次使用缓冲区时，创建和销毁它们都将占用大量资源，而缓冲区的垃圾回收过程也是如此。利用缓冲池，可以从缓冲池中获得缓冲区，使用缓冲区，然后在完成工作后将其返回给缓冲池。这样就避免了创建和销毁缓冲区的系统开销。
maxReceivedMessageSize	一个正整数，指定采用此绑定配置的通道上可以接收的最大消息大小（字节），包括消息头。如果消息超出此限制，则发送方将收到 SOAP 错误。接收方将删除该消息，并在跟踪日志中创建事件项。默认值为 65536。
name	一个包含绑定的配置名称的字符串。因为此值用作绑定的标识，所以它应该是唯一的。
openTimeout	一个 TimeSpan 值，指定为完成打开操作提供的时间间隔。此值应大于或等于 Zero。默认值为 00:01:00。
port	一个整数，指定此绑定将用于处理对等通道 TCP 消息的网络接口端口。该值必须介于 MinPort 和 MaxPort 之间。默认值为 0。
receiveTimeout	一个 TimeSpan 值，指定为完成接收操作提供的时间间隔。此值应大于或等于 Zero。默认值为 00:10:00。
sendTimeout	一个 TimeSpan 值，指定为完成发送操作提供的时间间隔。此值应大于或等于 Zero。默认值为 00:01:00。

子元素

元素	说明
<readerQuotas>	定义可由采用此绑定配置的终结点进行处理的 SOAP 消息的复杂性约束。此元素的类型为 XmlDictionaryReaderQuotasElement。
<resolver>	指定一个对等解析程序，此绑定将使用该解析程序将对等网格 ID 解析为对等网格中节点的终结点 IP 地址。
<netPeerBinding> 的 <security>	定义消息的安全设置。此元素的类型为 PeerSecurityElement。

父元素

元素	说明
<bindings>	此元素包含标准绑定和自定义绑定的集合。每一项均由其 name 进行标识。服务通过用 name 与绑定进行链接来使用绑定。

备注

此绑定为使用 TCP 上的对等传输创建对等应用程序或多方应用程序提供支持。每个对等节点均可承载使用此绑定类型定义的多个对等通道。

示例

下面的示例演示如何使用 NetPeerTcpBinding 绑定，该绑定使用对等通道提供多方通信。有关使用此绑定的详细方案，请参见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>

另请参见

参考

NetPeerTcpBinding
NetPeerTcpBindingElement

概念

其他资源

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