Поделиться через

<tcpTransport>

  • Статья

Определяет транспорт TCP, который может использоваться каналом для передачи сообщений для пользовательской привязки.

<Конфигурации>
  <system.serviceModel>
    <Привязки>
      <Custombinding>
        <Привязки>
          <tcpTransport>

Синтаксис

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

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут Описание
channelInitializationTimeout Возвращает или задает ограничение по времени для приема инициализации канала. Максимальное время в секундах, в течение которого канал может находиться в состоянии инициализации, прежде чем будет отключен. Эта квота включает время, необходимое TCP-подключению для проверки подлинности с помощью протокола кадрирования сообщений .NET. Клиенту необходимо отправить некоторые исходные данные, прежде чем сервер получит достаточно сведений для аутентификации. По умолчанию это 30 секунд.
connectionBufferSize Возвращает или задает размер буфера, используемого для передачи фрагмента сериализованного сообщения от клиента серверу по сети.
hostNameComparisonMode Возвращает или задает значение, указывающее, используется ли имя узла для доступа к службе при сопоставлении по универсальному коду ресурса (URI).
listenBacklog Максимальное количество запросов на соединение в очереди, которые могут ожидать обработки веб-службой. Атрибут connectionLeaseTimeout ограничивает время ожидания подключения клиентом до создания исключения подключения. Это свойство уровня сокетов, которое определяет максимальное количество запросов на подключение в очереди, которые могут ожидать обработки веб-службой. Если значение ListenBacklog слишком низкое, WCF перестанет принимать запросы и, следовательно, будет удалять новые подключения, пока сервер не подтвердит некоторые из существующих подключений в очереди. Значение по умолчанию — 16 * количество процессоров.
manualAddressing Возвращает или задает значение, показывающее, требуется ли создание адреса сообщения вручную.
maxBufferPoolSize Возвращает или задает максимальное значение буферных пулов, используемых транспортом.
maxBufferSize Возвращает или задает максимальный размер используемого буфера. Для потоковых сообщений это значение не должно быть меньше максимального возможного размера заголовков сообщения, считываемых в режиме буферизации.
maxOutputDelay Возвращает или задает максимальный промежуток времени, в течение которого фрагмент сообщения или все сообщение может оставаться в буфере перед отправкой.
maxPendingAccepts Возвращает или задает максимальное число ожидающих асинхронных операций приема, доступных для обработки входящих подключений к службе.
maxPendingConnections Возвращает или задает максимальное число подключений, ожидающих распределения в службе.
maxReceivedMessageSize Возвращает и задает максимально допустимый размер принимаемого сообщения.
portSharingEnabled Логическое значение, определяющее, включено ли совместное использование порта TCP для этого подключения. Если атрибут имеет значение false, каждая привязка будет использовать уникальный порт. Значение по умолчанию — false.

Этот параметр действителен только для служб. Клиенты не затрагиваются.

Использование этого параметра требует включения службы общего доступа к портам TCP Windows Communication Foundation (WCF) путем изменения типа запуска на «Вручную» или «Авто».
teredoEnabled Логическое значение, указывающее, используется ли Teredo (технология адресации клиентов, защищенных брандмауэром). Значение по умолчанию — false.

Это свойство включает использование Teredo для базового сокета TCP. Дополнительные сведения см. в разделе Общие сведения о Teredo.

Это свойство применимо только к Windows XP с пакетом обновления 2 (SP2) и Windows Server 2003. Windows Vista имеет параметр конфигурации Teredo на уровне компьютера, поэтому при запуске Vista это свойство игнорируется. Для Teredo необходимо, чтобы на компьютере, где работает служба, и на компьютере-клиенте был установлен и настроен правильно для использования Teredo стек протокола Microsoft IPv6.
transferMode Возвращает или задает значение, указывающее, следует ли помещать сообщения в буфер или передавать их потоком с использованием транспорта, ориентированного на подключение.
connectionPoolSettings Задает дополнительные параметры пула подключений для привязки именованного канала.

Дочерние элементы

Нет

Родительские элементы

Элемент Описание
<Привязки> Определяет все возможности пользовательской привязки.

Комментарии

Этот транспорт использует универсальные коды ресурсов (URI) вида net.tcp://hostname:port/path. Другие элементы универсального кода ресурса (URI) не обязательны.

Элемент tcpTransport является начальной точкой для создания пользовательской привязки, реализующей транспортный протокол TCP. Этот транспорт оптимизирован для взаимодействия между службами WCF.

См. также раздел