Udostępnij przez

<tcpTransport>

Definiuje transport TCP, który może być używany przez kanał do transferowania komunikatów dla powiązania niestandardowego.

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <tcpTransport>

Składnia

<tcpTransport channelInitializationTimeout="TimeSpan"
              connectionBufferSize="Integer"
              hostNameComparisonMode="StrongWildcard/Exact/WeakWildcard"
              listenBacklog="Integer"
              manualAddressing="Boolean"
              maxBufferPoolSize="Integer"
              maxBufferSize="Integer"
              maxOutputDelay="TimeSpan"
              maxPendingAccepts="Integer"
              maxPendingConnections="Integer"
              maxReceivedMessageSize="Integer"
              portSharingEnabled="Boolean"
              teredoEnabled="Boolean"
              transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse" >
  <connectionPoolSettings groupName="String"
                          idleTimeout="TimeSpan"
                          leaseTimeout="TimeSpan"
                          maxOutboundConnectionsPerEndpoint="Integer" />
</tcpTransport>

Atrybuty i elementy

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

Attributes

Attribute Description
channelInitializationTimeout Pobiera lub ustawia limit czasu inicjowania kanału do zaakceptowania. Maksymalny czas, w jaki kanał może znajdować się w stanie inicjowania przed odłączeniem w sekundach. Ten limit przydziału obejmuje czas, przez jaki połączenie TCP może potrwać do uwierzytelnienia się przy użyciu protokołu framing komunikatów platformy .NET. Klient musi wysłać dane początkowe, zanim serwer ma wystarczającą ilość informacji do przeprowadzenia uwierzytelniania. Wartość domyślna to 30 sekund.
connectionBufferSize Pobiera lub ustawia rozmiar buforu używanego do przesyłania fragmentu serializowanego komunikatu na przewodze z klienta lub usługi.
hostNameComparisonMode Pobiera lub ustawia wartość wskazującą, czy nazwa hosta jest używana do uzyskiwania dostępu do usługi podczas dopasowywania identyfikatora URI.
listenBacklog Maksymalna liczba żądań połączeń w kolejce, które mogą być oczekujące dla usługi sieci Web. Atrybut connectionLeaseTimeout ogranicza czas trwania, przez który klient będzie czekał na połączenie przed zgłoszeniem wyjątku połączenia. Jest to właściwość poziomu gniazda, która kontroluje maksymalną liczbę żądań połączeń w kolejce, które mogą być oczekujące dla usługi sieci Web. Gdy program ListenBacklog jest zbyt niski, program WCF przestanie akceptować żądania i w związku z tym usuwa nowe połączenia, dopóki serwer nie potwierdzi niektórych istniejących połączeń w kolejce. Wartość domyślna to 16 * liczba procesorów.
Manualaddressing Pobiera lub ustawia wartość wskazującą, czy wymagane jest ręczne adresowanie komunikatu.
maxBufferPoolSize Pobiera lub ustawia maksymalny rozmiar wszystkich pul używanych przez transport.
maxBufferSize Pobiera lub ustawia maksymalny rozmiar buforu do użycia. W przypadku komunikatów przesyłanych strumieniowo ta wartość powinna być co najmniej maksymalnym możliwym rozmiarem nagłówków komunikatów, które są odczytywane w trybie buforowania.
maxOutputDelay Pobiera lub ustawia maksymalny interwał czasu, przez który fragment komunikatu lub pełny komunikat może pozostać buforowany w pamięci przed wysłaniem.
Maxpendingaccepts Pobiera lub ustawia maksymalną liczbę oczekujących operacji asynchronicznych akceptowania, które są dostępne do przetwarzania połączeń przychodzących z usługą.
Maxpendingconnections Pobiera lub ustawia maksymalną liczbę połączeń oczekujących na wysłanie w usłudze.
maxReceivedMessageSize Pobiera i ustawia maksymalny dozwolony rozmiar komunikatu, który można odebrać.
portSharingEnabled Wartość logiczna określająca, czy udostępnianie portów TCP jest włączone dla tego połączenia. Jeśli jest falseto , każde powiązanie będzie używać własnego portu wyłącznego. Wartość domyślna to false.

To ustawienie jest istotne tylko dla usług. Nie ma to wpływu na klientów.

Użycie tego ustawienia wymaga włączenia usługi udostępniania portów TCP programu Windows Communication Foundation (WCF) przez zmianę typu uruchamiania na ręczne lub automatyczne
teredoEnabled Wartość logiczna określająca, czy teredo (technologia adresowania klientów, którzy znajdują się za zaporami) jest włączona. Wartość domyślna to false.

Ta właściwość włącza teredo dla bazowego gniazda TCP. Aby uzyskać więcej informacji, zobacz Teredo Overview (Omówienie teredo).

Ta właściwość ma zastosowanie tylko w systemach Windows XP z dodatkiem SP2 i Windows Server 2003. System Windows Vista ma opcję konfiguracji całej maszyny dla Teredo, więc podczas uruchamiania Vista ta właściwość jest ignorowana. Teredo wymaga, aby zarówno klient, jak i maszyny usługi miały zainstalowany stos IPv6 firmy Microsoft i został poprawnie skonfigurowany pod kątem użycia teredo.
transferMode Pobiera lub ustawia wartość wskazującą, czy komunikaty są buforowane, czy przesyłane strumieniowo z transportem zorientowanym na połączenie.
connectionPoolSettings Określa dodatkowe ustawienia puli połączeń dla powiązania nazwanego potoku.

Elementy podrzędne

Żaden

Elementy nadrzędne

Składnik Description
<wiążący> Definiuje wszystkie możliwości powiązania niestandardowego.

Uwagi

Ten transport używa identyfikatorów URI formularza "net.tcp://hostname:port/path". Inne składniki identyfikatora URI są opcjonalne.

Element tcpTransport jest punktem wyjścia do utworzenia powiązania niestandardowego, które implementuje protokół transportu TCP. Ten transport jest zoptymalizowany pod kątem komunikacji między WCF a WCF.

Zobacz także

  • Last updated on