<netPeerTcpBinding>

Cikk
06/21/2023

Definiál egy kötést a társcsatorna-specifikus TCP-üzenetkezeléshez.

<Konfigurációs>
  <system.serviceModel>
    <Kötések>
      <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>

Attribútumok és elemek

Az alábbi szakaszok az attribútumokat, a gyermekelemeket és a szülőelemeket ismertetik

Attribútumok

Attribútum	Leírás
closeTimeout	Egy TimeSpan érték, amely megadja a bezárási művelet végrehajtásához megadott időintervallumot. Ennek az értéknek nagyobbnak vagy egyenlőnek kell lennie.Zero Az alapértelmezett érték 00:01:00.
listenIPAddress	Egy sztring, amely megadja azt az IP-címet, amelyen a társcsomópont figyelni fogja a TCP-üzeneteket. A mező alapértelmezett értéke: `null`.
maxBufferPoolSize	Egy egész szám, amely meghatározza a kötés pufferkészletének maximális méretét. Az alapértelmezett érték 524 288 bájt (512 * 1024). A Windows Communication Foundation (WCF) számos része puffereket használ. A pufferek létrehozása és megsemmisítése minden alkalommal költséges, és a pufferek szemétgyűjtése is költséges. Pufferkészletek esetén a készletből puffert vehet fel, használhatja, majd a művelet befejezése után visszaadhatja a készletnek. Így elkerülhető a pufferek létrehozására és megsemmisítésére vonatkozó többletterhelés.
maxReceivedMessageSize	Pozitív egész szám, amely a kötéssel konfigurált csatornán fogadható maximális üzenetméretet adja meg bájtban, beleértve a fejléceket is. A korlátot túllépő üzenet feladója SOAP-hibát kap. A fogadó eldobja az üzenetet, és létrehozza az esemény bejegyzését a nyomkövetési naplóban. Az alapértelmezett érték a 65536.
name	A kötés konfigurációs nevét tartalmazó sztring. Ennek az értéknek egyedinek kell lennie, mert a kötés azonosítására szolgál. A .NET-keretrendszer 4-től kezdődően a kötéseknek és viselkedéseknek nem kell nevet adniuk. Az alapértelmezett konfigurációval, valamint a név nélküli kötésekkel és viselkedésekkel kapcsolatos további információkért lásd: Egyszerűsített konfiguráció és egyszerűsített konfiguráció a WCF-szolgáltatásokhoz.
openTimeout	Egy TimeSpan érték, amely megadja a nyitott művelet végrehajtásához megadott időintervallumot. Ennek az értéknek nagyobbnak vagy egyenlőnek kell lennie.Zero Az alapértelmezett érték 00:01:00.
port	Egy egész szám, amely megadja azt a hálózati adapterportot, amelyen ez a kötés feldolgozni fogja a társcsatorna TCP-üzeneteit. Ennek az értéknek és MaxPortközött MinPort kell lennie. Az alapértelmezett érték a 0.
receiveTimeout	Egy TimeSpan érték, amely megadja a fogadási művelet végrehajtásához megadott időintervallumot. Ennek az értéknek nagyobbnak vagy egyenlőnek kell lennie.Zero Az alapértelmezett érték 00:10:00.
sendTimeout	Egy TimeSpan érték, amely megadja a küldési művelet végrehajtásához megadott időintervallumot. Ennek az értéknek nagyobbnak vagy egyenlőnek kell lennie.Zero Az alapértelmezett érték 00:01:00.

Gyermekelemek

Elem	Leírás
<readerQuotas>	Meghatározza a SOAP-üzenetek összetettségére vonatkozó korlátozásokat, amelyeket az ezzel a kötéssel konfigurált végpontok dolgozhatnak fel. Ez az elem típusa XmlDictionaryReaderQuotasElement.
<Feloldási>	A kötés által használt társfeloldót adja meg a társhálózati háló azonosítójának a társhálón belüli csomópontok végponti IP-címére való feloldásához.
<Biztonsági>	Meghatározza az üzenet biztonsági beállításait. Ez az elem típusa PeerSecurityElement.

Szülőelemek

Elem	Leírás
<Kötések>	Ez az elem standard és egyéni kötések gyűjteményét tartalmazza.

Megjegyzések

Ez a kötés támogatja a társközi vagy többrészes alkalmazások tcp-alapú társátvitelt használó létrehozását. Minden társcsomópont több, ezzel a kötéstípussal definiált társcsatornát is üzemeltethet.

Példa

Az alábbi példa a NetPeerTcpBinding kötés használatát mutatja be, amely többrészes kommunikációt biztosít egy társcsatorna használatával. A kötés használatának részletes forgatókönyvét lásd: 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>

Megosztás a következőn keresztül: