<tcpTransport>

Artykuł
05/10/2023

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 `false`to 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.

Udostępnij za pośrednictwem