定義了對等通道專屬 TCP 訊息的綁定。
<configuration>
<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>
屬性和項目
下列各節說明屬性、子元素和父元素
Attributes
| Attribute | Description |
|---|---|
| 結束 時間 | 一個 TimeSpan 指定緊密操作完成所需時間間隔的值。 此值應大於或等 Zero於 。 預設值是 00：01：00。 |
| listenIPAddress | 一個字串，指定對等節點將監聽 TCP 訊息的 IP 位址。 預設值為 null。 |
| maxBufferPoolSize | 一個整數，指定此綁定的最大緩衝池大小。 預設為 524,288 位元組（512 × 1024）。 Windows 通訊基礎（WCF）的許多部分都使用緩衝區。 每次使用緩衝區都建立與銷毀成本高昂，緩衝區的垃圾回收也同樣昂貴。 使用緩衝池時，你可以從緩衝池中取一個緩衝區，使用完畢後再歸還給池。 因此避免了建立與銷毀緩衝區的開銷。 |
| 最大接收訊息大小 | 一個正整數，指定在設定此綁定的通道上可接收的最大訊息大小（以位元組計，包括標頭）。 超過此限制的訊息發送者將收到 SOAP 錯誤。 接收端會丟棄訊息，並在追蹤日誌中建立事件的條目。 預設是 65536。 |
| 名稱 | 一個包含綁定設定名稱的字串。 這個值應該是唯一的，因為它是用來識別裝訂的。 從 .NET Framework 4 開始，綁定和行為不再需要名稱。 欲了解更多關於預設設定及無名綁定與行為的資訊，請參閱簡化設定與簡化配置（Simplified Configuration for WCF Services）。 |
| openTimeout | 一個 TimeSpan 指定開啟操作完成所需時間區間的值。 此值應大於或等 Zero於 。 預設值是 00：01：00。 |
| 傳輸埠 | 一個整數，指定此綁定將處理對等通道 TCP 訊息的網路介面埠。 此值必須介於 MinPort 與 MaxPort之間。 預設值為 0。 |
| 收到Timeout | 一個 TimeSpan 指定接收操作完成所需時間區間的值。 此值應大於或等 Zero於 。 預設值是 00：10：00。 |
| sendTimeout | 一個 TimeSpan 指定傳送操作完成所需時間間隔的值。 此值應大於或等 Zero於 。 預設值是 00：01：00。 |
子專案
| 元素 | Description |
|---|---|
| <讀者配額> | 定義了由端點可處理的 SOAP 訊息複雜度的限制，這些訊息可由配置為此綁定的端點所能處理。 此元素的類型 XmlDictionaryReaderQuotasElement為 。 |
| <解析器> | 指定此綁定所用的對等解析器，將對等網格 ID 解析為節點節點的端點 IP 位址。 |
| <安全> | 定義訊息的安全設定。 此元素的類型 PeerSecurityElement為 。 |
父項目
| 元素 | Description |
|---|---|
| <裝訂> | 此元素包含標準與自訂裝訂的集合。 |
備註
此綁定支援利用 TCP 上的點對點傳輸建立點對點或多方應用程式。 每個節點可承載多個以此綁定類型定義的對等通道。
Example
以下範例展示了使用 NetPeerTcpBinding 綁定，該綁定提供透過對等通道進行多方通訊。 關於使用此綁定的詳細情境，請參見網路對等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>
