<netPeerTcpBinding>

Článek
07/07/2023

Definuje vazbu pro zasílání zpráv TCP specifický pro peer kanál.

<Konfigurace>
  <System.servicemodel>
    <Vazby>
      <netPeerTcpBinding>

Syntax

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

Atributy a elementy

Následující části popisují atributy, podřízené a nadřazené elementy.

Atributy

Atribut	Popis
closeTimeout	Hodnota TimeSpan , která určuje časový interval zadaný pro dokončení operace uzavření. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00.
listenIPAddress	Řetězec, který určuje IP adresu, na které bude partnerský uzel naslouchat zprávě protokolu TCP. Výchozí formát je `null`.
Maxbufferpoolsize	Celé číslo, které určuje maximální velikost fondu vyrovnávacích pamětí pro tuto vazbu. Výchozí hodnota je 524 288 bajtů (512 × 1024). Mnoho částí Windows Communication Foundation (WCF) používá vyrovnávací paměti. Vytváření a ničení vyrovnávacích pamětí při každém jejich použití je nákladné a uvolňování paměti pro vyrovnávací paměti je také nákladné. Pomocí fondů vyrovnávacích pamětí můžete z fondu vzít vyrovnávací paměť, použít ji a po dokončení ji vrátit do fondu. Tím se vyhnete režijní režii při vytváření a ničení vyrovnávacích pamětí.
Maxreceivedmessagesize	Kladné celé číslo, které určuje maximální velikost zprávy v bajtech včetně hlaviček, které lze přijímat v kanálu nakonfigurovaného pomocí této vazby. Odesílatel zprávy překračující tento limit obdrží chybu SOAP. Příjemce zprávu zahodí a vytvoří záznam události v protokolu trasování. Výchozí hodnota je 65536.
name	Řetězec, který obsahuje název konfigurace vazby. Tato hodnota by měla být jedinečná, protože se používá jako identifikace vazby. Počínaje rozhraním .NET Framework 4 není nutné, aby vazby a chování měly název. Další informace o výchozí konfiguraci a bezpomenných vazbách a chování najdete v tématu Zjednodušená konfigurace a zjednodušená konfigurace pro služby WCF.
openTimeout	Hodnota TimeSpan , která určuje časový interval zadaný pro dokončení operace otevření. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00.
port	Celé číslo, které určuje port síťového rozhraní, na kterém bude tato vazba zpracovávat zprávy TCP partnerského kanálu. Tato hodnota musí být mezi MinPort a MaxPort. Výchozí hodnota je 0.
receiveTimeout	Hodnota TimeSpan , která určuje časový interval zadaný pro dokončení operace příjmu. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:10:00.
sendTimeout	Hodnota TimeSpan , která určuje časový interval zadaný pro dokončení operace odeslání. Tato hodnota by měla být větší nebo rovna Zero. Výchozí hodnota je 00:01:00.

Podřízené elementy

Element	Popis
<čtenářQuotas>	Definuje omezení složitosti zpráv SOAP, které mohou být zpracovány koncovými body nakonfigurovanými pomocí této vazby. Tento prvek je typu XmlDictionaryReaderQuotasElement.
<Překládání>	Určuje překladač partnerských uzlů, který tato vazba používá k překladu ID partnerské sítě na IP adresy koncových bodů uzlů v rámci partnerské sítě.
<Zabezpečení>	Definuje nastavení zabezpečení zprávy. Tento prvek je typu PeerSecurityElement.

Nadřazené elementy

Element	Popis
<Vazby>	Tento element obsahuje kolekci standardních a vlastních vazeb.

Poznámky

Tato vazba poskytuje podporu pro vytváření aplikací typu peer-to-peer nebo aplikací s více dvěma účastníky pomocí přenosu peer přes protokol TCP. Každý partnerský uzel může hostovat více partnerských kanálů definovaných tímto typem vazby.

Příklad

Následující příklad ukazuje použití NetPeerTcpBinding vazby, která poskytuje vícestrannou komunikaci pomocí partnerského kanálu. Podrobný scénář použití této vazby najdete v tématu 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>

Sdílet prostřednictvím