<netPeerTcpBinding>

Artikel
06/21/2023

Definierar en bindning för peer-kanalspecifika TCP-meddelanden.

<Konfiguration>
  <system.serviceModel>
    <Bindningar>
      <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>

Attribut och element

Följande avsnitt beskriver attribut, underordnade element och överordnade element

Attribut

Attribut	Beskrivning
closeTimeout	Ett TimeSpan värde som anger tidsintervallet för en stängningsåtgärd som ska slutföras. Det här värdet ska vara större än eller lika med Zero. Standardvärdet är 00:01:00.
listenIPAddress	En sträng som anger en IP-adress där peer-noden lyssnar efter TCP-meddelanden. Standardvärdet är `null`.
maxBufferPoolSize	Ett heltal som anger den maximala buffertpoolstorleken för den här bindningen. Standardvärdet är 524 288 byte (512 * 1024). Många delar av Windows Communication Foundation (WCF) använder buffertar. Att skapa och förstöra buffertar varje gång de används är dyrt, och skräpinsamling för buffertar är också dyrt. Med buffertpooler kan du ta en buffert från poolen, använda den och returnera den till poolen när du är klar. Därmed undviks kostnaden för att skapa och förstöra buffertar.
maxReceivedMessageSize	Ett positivt heltal som anger den maximala meddelandestorleken i byte, inklusive rubriker, som kan tas emot på en kanal som konfigurerats med den här bindningen. Avsändaren av ett meddelande som överskrider den här gränsen får ett SOAP-fel. Mottagaren släpper meddelandet och skapar en post för händelsen i spårningsloggen. Standardvärdet är 65536.
name	En sträng som innehåller bindningens konfigurationsnamn. Det här värdet bör vara unikt eftersom det används som identifiering för bindningen. Från och med .NET Framework 4 krävs inte bindningar och beteenden för att ha ett namn. Mer information om standardkonfiguration och namnlösa bindningar och beteenden finns i Förenklad konfiguration och förenklad konfiguration för WCF-tjänster.
openTimeout	Ett TimeSpan värde som anger hur länge en öppen åtgärd ska slutföras. Det här värdet ska vara större än eller lika med Zero. Standardvärdet är 00:01:00.
port	Ett heltal som anger den nätverksgränssnittsport där bindningen bearbetar TCP-meddelanden för peer-kanal. Det här värdet måste vara mellan MinPort och MaxPort. Standardvärdet är 0.
receiveTimeout	Ett TimeSpan värde som anger hur länge en mottagningsåtgärd ska slutföras. Det här värdet ska vara större än eller lika med Zero. Standardvärdet är 00:10:00.
sendTimeout	Ett TimeSpan värde som anger hur länge en sändningsåtgärd ska slutföras. Det här värdet ska vara större än eller lika med Zero. Standardvärdet är 00:01:00.

Underordnade element

Element	Beskrivning
<readerQuotas>	Definierar begränsningarna för komplexiteten i SOAP-meddelanden som kan bearbetas av slutpunkter som konfigurerats med den här bindningen. Det här elementet är av typen XmlDictionaryReaderQuotasElement.
<Resolver>	Anger en peer-matchare som används av den här bindningen för att matcha ett peer mesh-ID till slutpunkts-IP-adresserna för noder i peer-nätet.
<Säkerhet>	Definierar säkerhetsinställningarna för meddelandet. Det här elementet är av typen PeerSecurityElement.

Överordnade element

Element	Beskrivning
<Bindningar>	Det här elementet innehåller en samling standard- och anpassade bindningar.

Kommentarer

Den här bindningen ger stöd för att skapa peer-to-peer- eller multiparty-program med hjälp av peer-transport via TCP. Varje peer-nod kan vara värd för flera peer-kanaler som definierats med den här bindningstypen.

Exempel

I följande exempel visas hur du använder NetPeerTcpBinding-bindningen, som tillhandahåller kommunikation med flera delar med hjälp av en peer-kanal. Ett detaljerat scenario med att använda den här bindningen finns i 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>

Dela via