共用方式為

<netPeerTcpBinding>

  • 發行項

為對等通道特定的 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 位址。 預設為 null。

maxBufferPoolSize

指定此繫結之緩衝區集區大小上限的整數。 預設為 524,288 個位元組 (512 * 1024)。 Windows Communication Foundation (WCF) 的許多部分會使用緩衝區。 每次使用這些組件時建立並終結緩衝區是高度耗費資源的作業，回收緩衝區的記憶體也是如此。 有了緩衝集區，您就可以從集區取出緩衝區來使用，用完後再還給集區， 因此可以避免建立及終結緩衝區的負荷。

maxReceivedMessageSize

正整數，指定在使用此繫結設定之通道上可以接收的訊息大小上限 (以位元組為單位，包括標頭)。 超出此限制之訊息的寄件者將會收到 SOAP 錯誤。 收件者會捨棄訊息，然後在追蹤記錄檔中建立此事件的項目。 預設為 65536。

name

包含此繫結之組態名稱的字串。 這個值應該是唯一的，因為它會當做繫結的識別使用。 從 .NET Framework 4 開始，繫結和行為都不需要有名稱。 如需預設組態和無名稱繫結與行為的詳細資訊，請參閱Simplified Configuration和Simplified Configuration for WCF Services。

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>

這個項目會保存標準和自訂繫結的集合。

備註

這個繫結使用透過 TCP 的對等傳輸，藉此支援對等或多方應用程式的建立。 每個對等節點都可以裝載多個以這個繫結類型所定義的對等通道。

範例

下列範例示範使用 NetPeerTcpBinding 繫結，此繫結會使用對等通道提供多方通訊。 如需使用這個繫結的詳細案例，請參閱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>

另請參閱

參考

NetPeerTcpBinding
NetPeerTcpBindingElement

概念

<binding>

其他資源

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