<Netpeertcpbinding>

Artykuł
06/21/2023

Definiuje powiązanie dla komunikatów TCP specyficznych dla kanału równorzędnego.

<Konfiguracji>
  <System.servicemodel>
    <Powiązania>
      <Netpeertcpbinding>

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne

Atrybuty

Atrybut	Opis
closeTimeout	TimeSpan Wartość określająca interwał czasu określony dla zakończenia operacji zamknięcia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.
listenIPAddress	Ciąg określający adres IP, na którym węzeł równorzędny będzie nasłuchiwać komunikatów TCP. Wartość domyślna to `null`.
Maxbufferpoolsize	Liczba całkowita określająca maksymalny rozmiar puli buforów dla tego powiązania. Wartość domyślna to 524 288 bajtów (512 * 1024). Wiele części programu Windows Communication Foundation (WCF) używa buforów. Tworzenie i niszczenie buforów za każdym razem, gdy są używane, jest kosztowne, a odzyskiwanie pamięci dla buforów jest również kosztowne. W przypadku pul buforów można pobrać bufor z puli, użyć go i wrócić do puli po zakończeniu pracy. W związku z tym unika się nakładu pracy podczas tworzenia i niszczenia buforów.
Maxreceivedmessagesize	Dodatnia liczba całkowita określająca maksymalny rozmiar komunikatu w bajtach, w tym nagłówki, które można odebrać w kanale skonfigurowanym za pomocą tego powiązania. Nadawca komunikatu przekraczającego ten limit otrzyma błąd PROTOKOŁU SOAP. Odbiorca pominie komunikat i tworzy wpis zdarzenia w dzienniku śledzenia. Wartość domyślna to 65536.
name	Ciąg zawierający nazwę konfiguracji powiązania. Ta wartość powinna być unikatowa, ponieważ jest używana jako identyfikacja powiązania. Począwszy od .NET Framework 4, powiązania i zachowania nie muszą mieć nazwy. Aby uzyskać więcej informacji na temat domyślnej konfiguracji i bez nazw powiązań i zachowań, zobacz Uproszczone konfigurowanie i uproszczona konfiguracja dla usług WCF.
openTimeout	TimeSpan Wartość określająca interwał czasu określony dla operacji otwierania do ukończenia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.
port	Liczba całkowita określająca port interfejsu sieciowego, na którym to powiązanie będzie przetwarzać komunikaty TCP kanału równorzędnego. Ta wartość musi zawierać się między MinPort i MaxPort. Wartość domyślna to 0.
Receivetimeout	TimeSpan Wartość określająca interwał czasu określony dla wykonania operacji odbierania. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:10:00.
sendTimeout	TimeSpan Wartość określająca interwał czasu określony dla operacji wysyłania do ukończenia. Ta wartość powinna być większa lub równa Zero. Wartość domyślna to 00:01:00.

Elementy podrzędne

Element	Opis
<Readerquotas>	Definiuje ograniczenia dotyczące złożoności komunikatów PROTOKOŁU SOAP, które mogą być przetwarzane przez punkty końcowe skonfigurowane za pomocą tego powiązania. Ten element jest typu XmlDictionaryReaderQuotasElement.
<Programu rozpoznawania nazw>	Określa rozpoznawanie elementów równorzędnych używanych przez to powiązanie do rozpoznawania identyfikatora siatki równorzędnej do adresów IP punktów końcowych węzłów w sieci równorzędnej.
<Zabezpieczeń>	Definiuje ustawienia zabezpieczeń komunikatu. Ten element jest typu PeerSecurityElement.

Elementy nadrzędne

Element	Opis
<Powiązania>	Ten element zawiera kolekcję powiązań standardowych i niestandardowych.

Uwagi

To powiązanie zapewnia obsługę tworzenia aplikacji równorzędnych lub wielopartyjnych przy użyciu transportu równorzędnego za pośrednictwem protokołu TCP. Każdy węzeł równorzędny może hostować wiele kanałów równorzędnych zdefiniowanych przy użyciu tego typu powiązania.

Przykład

W poniższym przykładzie pokazano użycie powiązania NetPeerTcpBinding, które zapewnia komunikację wielopartyjną przy użyciu kanału równorzędnego. Aby uzyskać szczegółowy scenariusz użycia tego powiązania, zobacz 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>

Udostępnij za pośrednictwem