<netPeerTcpBinding>

Статья
02/28/2011

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

Иерархия схемы

<system.serviceModel>
<bindings>
<netPeerTcpBinding>

Синтаксис

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

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

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

Атрибуты

Атрибут	Описание
closeTimeout	Значение TimeSpan, которое задает длительность времени ожидания для завершения операции закрытия. Это значение должно быть больше или равно Zero. Значение по умолчанию — 00:01:00.
listenIPAddress	Строка, указывающая IP-адрес, на котором одноранговый узел будет ожидать TCP-сообщения. Значение по умолчанию — null.
maxBufferPoolSize	Целое число, задающее максимальный размер буферного пула для этой привязки. Значение по умолчанию — 524 288 байт (512 * 1024). Многие элементы Windows Communication Foundation (WCF) используют буферы. При создании буферов и их уничтожении после каждого использования расходуется слишком много ресурсов; при сборке мусора для буферов также расходуется слишком много ресурсов. Буферные пулы позволяют брать буфер из пула, использовать его, а затем возвращать обратно, когда он больше не требуется. Это позволяет избежать излишней нагрузки, связанной с созданием и уничтожением буферов.
maxReceivedMessageSize	Положительное целое число, задающее, в байтах, максимальный размер сообщения (включая заголовки), которое можно получить по каналу, настроенному с использованием этой привязки. Отправитель сообщения, превышающего это ограничение, получит ошибку SOAP. Получатель отклоняет сообщение и создает запись о событии в журнале трассировки. Значение по умолчанию — 65536.
name	Строка, содержащая имя конфигурации привязки. Это значение должно быть уникальным, поскольку оно используется в качестве идентификатора привязки. Начиная с версии .NET Framework 4 для привязок и поведений необязательно задавать имена. Дополнительные сведения о конфигурации по умолчанию и о безымянных привязках и поведениях см. в разделах Simplified Configuration и Simplified Configuration for WCF Services.
openTimeout	Значение TimeSpan, которое задает длительность времени ожидания для завершения операции открытия. Это значение должно быть больше или равно Zero. Значение по умолчанию — 00:01:00.
port	Целое число, задающее порт сетевого интерфейса, на котором эта привязка будет обрабатывать TCP-сообщения однорангового канала. Это значение должно принадлежать диапазону от MinPort до MaxPort. Значение по умолчанию — 0.
receiveTimeout	Значение TimeSpan, которое задает длительность времени ожидания для завершения операции получения. Это значение должно быть больше или равно Zero. Значение по умолчанию — 00:10:00.
sendTimeout	Значение TimeSpan, которое задает длительность времени ожидания для завершения операции отправки. Это значение должно быть больше или равно Zero. Значение по умолчанию — 00:01:00.

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

Элемент	Описание
<readerQuotas>	Определяет ограничения по сложности сообщений SOAP, которые могут обрабатываться конечными точками, настроенными с использованием этой привязки. Это элемент типа XmlDictionaryReaderQuotasElement.
<resolver>	Указывает распознаватель одноранговых узлов, используемый данной привязкой для разрешения идентификаторов сетки одноранговых узлов в IP-адреса конечных точек узлов этой сетки.
<security> для <netPeerBinding>	Определяет параметры безопасности сообщения. Это элемент типа PeerSecurityElement.

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

Элемент	Описание
<bindings>	Этот элемент содержит коллекцию стандартных и пользовательских привязок.

Замечания

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

Пример

Следующий пример демонстрирует применение привязки NetPeerTcpBinding, обеспечивающей многопользовательскую связь с использованием однорангового канала. Подробный сценарий применения этой привязки см. в разделе 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>

См. также

Справочник

NetPeerTcpBinding
NetPeerTcpBindingElement

Основные понятия

Другие ресурсы

Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients
Net Peer TCP
Peer-to-Peer Networking

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