<tcpTransport>

  • Artykuł

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

<Konfiguracji>
  <System.servicemodel>
    <Powiązania>
      <Custombinding>
        <Wiązania>
          <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.

Atrybuty

Atrybut Opis
channelInitializationTimeout Pobiera lub ustawia limit czasu inicjowania kanału do zaakceptowania. Maksymalny czas, w jaki kanał może znajdować się w stanie inicjowania przed rozłączeniem w sekundach. Ten limit przydziału obejmuje czas, przez który połączenie TCP może potrwać do uwierzytelnienia się przy użyciu protokołu framing komunikatów platformy .NET. Klient musi wysłać pewne dane początkowe, zanim serwer ma wystarczającą ilość informacji, aby przeprowadzić uwierzytelnianie. Wartość domyślna to 30 sekund.
connectionBufferSize Pobiera lub ustawia rozmiar buforu używanego do przesyłania fragmentu serializowanego komunikatu w sieci z klienta lub usługi.
Hostnamecomparisonmode Pobiera lub ustawia wartość wskazującą, czy nazwa hosta jest używana do osiągnięcia usługi podczas dopasowywania identyfikatora URI.
listenBacklog Maksymalna liczba oczekujących żądań połączenia w kolejce dla usługi sieci Web. Atrybut connectionLeaseTimeout ogranicza czas trwania połączenia klienta przed zgłoszeniem wyjątku połączenia. Jest to właściwość na poziomie gniazda, która kontroluje maksymalną liczbę żądań połączeń w kolejce, które mogą być oczekujące dla usługi sieci Web. Gdy funkcja ListenBacklog jest za mała, 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 buforów 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 buforowym.
maxOutputDelay Pobiera lub ustawia maksymalny interwał czasu, przez który część komunikatu lub pełny komunikat może pozostać buforowany w pamięci przed wysłaniem.
Maxpendingaccepts Pobiera lub ustawia maksymalną liczbę oczekujących operacji akceptowania asynchronicznych, 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 dla tego połączenia włączono udostępnianie portów TCP. Jeśli jest falseto wartość , 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ę jego 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ść umożliwia 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 systemu Vista ta właściwość jest ignorowana. Teredo wymaga, aby zarówno komputery klienckie, jak i 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

Brak

Elementy nadrzędne

Element Opis
<Wiązania> 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 WCF-to-WCF.

Zobacz też