Freigeben über

<netPeerTcpBinding>

Definiert eine Bindung für peerkanalspezifische TCP-Nachrichten.

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Merkmal Description
closeTimeout Ein TimeSpan Wert, der das Zeitintervall angibt, das für einen abschlussden Vorgang bereitgestellt wird. Dieser Wert sollte größer oder gleich Zerosein. Der Standardwert ist 00:01:00.
listenIPAddress Eine Zeichenfolge, die eine IP-Adresse angibt, auf der der Peerknoten AUF TCP-Nachrichten lauscht. Der Standardwert lautet null.
maxBufferPoolSize Eine ganze Zahl, die die maximale Pufferpoolgröße für diese Bindung angibt. Der Standardwert ist 524.288 Bytes (512 * 1024). Viele Teile von Windows Communication Foundation (WCF) verwenden Puffer. Das Erstellen und Zerstören von Puffern jedes Mal, wenn sie verwendet werden, ist teuer, und die Garbage Collection für Puffer ist ebenfalls teuer. Mit Pufferpools können Sie einen Puffer aus dem Pool übernehmen, ihn verwenden und nach Abschluss an den Pool zurückgeben. So wird der Aufwand beim Erstellen und Zerstören von Puffern vermieden.
maxReceivedMessageSize Eine positive ganze Zahl, die die maximale Nachrichtengröße in Bytes einschließlich Kopfzeilen angibt, die in einem Kanal empfangen werden können, der mit dieser Bindung konfiguriert ist. Der Absender einer Nachricht, die diesen Grenzwert überschreitet, erhält einen SOAP-Fehler. Der Empfänger legt die Nachricht ab und erstellt einen Eintrag des Ereignisses im Ablaufverfolgungsprotokoll. Der Standardwert ist 65536.
name Eine Zeichenfolge, die den Konfigurationsnamen der Bindung enthält. Dieser Wert sollte eindeutig sein, da er als Identifikation für die Bindung verwendet wird. Ab .NET Framework 4 müssen Bindungen und Verhaltensweisen keinen Namen haben. Weitere Informationen zu Standardkonfigurationen und namenslosen Bindungen und Verhaltensweisen finden Sie unter Vereinfachte Konfiguration und vereinfachte Konfiguration für WCF-Dienste.
openTimeout Ein TimeSpan Wert, der das Für den Abschluss eines geöffneten Vorgangs bereitgestellte Zeitintervall angibt. Dieser Wert sollte größer oder gleich Zerosein. Der Standardwert ist 00:01:00.
port Eine ganze Zahl, die den Netzwerkschnittstellenport angibt, an dem diese Bindung TCP-Nachrichten im Peerkanal verarbeitet. Dieser Wert muss zwischen MinPort und MaxPort. Der Standardwert ist 0.
receiveTimeout Ein TimeSpan Wert, der das Für den Abschluss eines Empfangsvorgangs bereitgestellte Zeitintervall angibt. Dieser Wert sollte größer oder gleich Zerosein. Der Standardwert ist 00:10:00.
sendTimeout Ein TimeSpan Wert, der das Für den Abschluss eines Sendevorgangs bereitgestellte Zeitintervall angibt. Dieser Wert sollte größer oder gleich Zerosein. Der Standardwert ist 00:01:00.

Untergeordnete Elemente

Element Description
<readerQuotas> Definiert die Einschränkungen für die Komplexität von SOAP-Nachrichten, die von Endpunkten verarbeitet werden können, die mit dieser Bindung konfiguriert sind. Dieses Element ist vom Typ XmlDictionaryReaderQuotasElement.
<Resolver> Gibt einen Peer-Resolver an, der von dieser Bindung verwendet wird, um eine Peer-Gitter-ID in die Endpunkt-IP-Adressen von Knoten innerhalb des Peergitters aufzulösen.
<Sicherheit> Definiert die Sicherheitseinstellungen für die Nachricht. Dieses Element ist vom Typ PeerSecurityElement.

Übergeordnete Elemente

Element Description
<Einbände> Dieses Element enthält eine Sammlung von Standard- und benutzerdefinierten Bindungen.

Bemerkungen

Diese Bindung bietet Unterstützung für die Erstellung von Peer-to-Peer- oder Mehrparteienanwendungen mit Peer-Transport über TCP. Jeder Peerknoten kann mehrere Peerkanäle hosten, die mit diesem Bindungstyp definiert sind.

Example

Im folgenden Beispiel wird die Verwendung der NetPeerTcpBinding-Bindung veranschaulicht, die kommunikation mit mehreren Teilnehmern mithilfe eines Peerkanals bereitstellt. Ein detailliertes Szenario für die Verwendung dieser Bindung finden Sie unter 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>

Siehe auch

  • Last updated on