<netPeerTcpBinding>

Artikel
07/07/2023

Definieert een binding voor peerkanaalspecifieke TCP-berichten.

<Configuratie>
  <system.serviceModel>
    <Bindings>
      <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>

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven

Kenmerken

Kenmerk	Beschrijving
closeTimeout	Een TimeSpan waarde die het tijdsinterval aangeeft dat is opgegeven voor het voltooien van een bijna-bewerking. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
listenIPAddress	Een tekenreeks die een IP-adres aangeeft waarop het peerknooppunt luistert naar TCP-berichten. De standaardwaarde is `null`.
maxBufferPoolSize	Een geheel getal dat de maximale grootte van de buffergroep voor deze binding aangeeft. De standaardwaarde is 524.288 bytes (512 * 1024). Veel onderdelen van Windows Communication Foundation (WCF) maken gebruik van buffers. Het maken en vernietigen van buffers elke keer dat ze worden gebruikt, is duur en garbagecollection voor buffers is ook duur. Met bufferpools kunt u een buffer uit de pool nemen, deze gebruiken en teruggaan naar de pool zodra u klaar bent. Zo wordt de overhead bij het maken en vernietigen van buffers vermeden.
maxReceivedMessageSize	Een positief geheel getal dat de maximale berichtgrootte aangeeft, in bytes, inclusief headers, die kunnen worden ontvangen op een kanaal dat is geconfigureerd met deze binding. De afzender van een bericht dat deze limiet overschrijdt, ontvangt een SOAP-fout. De ontvanger verwijdert het bericht en maakt een vermelding van de gebeurtenis in het traceringslogboek. De standaardwaarde is 65536.
naam	Een tekenreeks die de configuratienaam van de binding bevat. Deze waarde moet uniek zijn omdat deze wordt gebruikt als identificatie voor de binding. Vanaf .NET Framework 4 hoeven bindingen en gedrag geen naam te hebben. Zie Vereenvoudigde configuratie en vereenvoudigde configuratie voor WCF-services voor meer informatie over standaardconfiguratie en naamloze bindingen en gedrag.
openTimeout	Een TimeSpan waarde die het tijdsinterval aangeeft dat is opgegeven voor het voltooien van een open bewerking. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.
poort	Een geheel getal dat de netwerkinterfacepoort aangeeft waarop deze binding TCP-berichten van het peerkanaal verwerkt. Deze waarde moet zich tussen MinPort en .MaxPort De standaardwaarde is 0.
receiveTimeout	Een TimeSpan waarde die het tijdsinterval aangeeft dat is opgegeven voor het voltooien van een ontvangstbewerking. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:10:00.
sendTimeout	Een TimeSpan waarde die het tijdsinterval aangeeft dat is opgegeven voor het voltooien van een verzendbewerking. Deze waarde moet groter zijn dan of gelijk zijn aan Zero. De standaardwaarde is 00:01:00.

Onderliggende elementen

Element	Beschrijving
<readerQuotas>	Definieert de beperkingen voor de complexiteit van SOAP-berichten die kunnen worden verwerkt door eindpunten die met deze binding zijn geconfigureerd. Dit element is van het type XmlDictionaryReaderQuotasElement.
<Resolver>	Hiermee geeft u een peer-resolver op die door deze binding wordt gebruikt om een peer-mesh-id op te lossen naar de EINDPUNT-IP-adressen van knooppunten binnen de peer-mesh.
<Veiligheid>	Hiermee definieert u de beveiligingsinstellingen voor het bericht. Dit element is van het type PeerSecurityElement.

Bovenliggende elementen

Element	Beschrijving
<Bindings>	Dit element bevat een verzameling standaard- en aangepaste bindingen.

Opmerkingen

Deze binding biedt ondersteuning voor het maken van peer-to-peer- of multiparty-toepassingen met behulp van peertransport via TCP. Elk peerknooppunt kan meerdere peerkanalen hosten die zijn gedefinieerd met dit bindingstype.

Voorbeeld

In het volgende voorbeeld ziet u het gebruik van de Binding NetPeerTcpBinding, die communicatie met meerdere partijen biedt met behulp van een peerkanaal. Zie Net Peer TCP voor een gedetailleerd scenario voor het gebruik van deze binding.

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

Delen via