<wsHttpBinding>

Определяет безопасную, надежную, совместимую привязку, подходящую для контрактов служб, не являющихся дуплексными. Привязка реализует следующие спецификации: WS-Reliable Обмен сообщениями для надежности и WS-Security для обеспечения безопасности сообщений и проверки подлинности. Транспорт — HTTP, а кодировка сообщений — text/XML.

<configuration>
  <system.serviceModel>
    <bindings>
      <wsHttpBinding>

Синтаксис

<wsHttpBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="integer"
           maxReceivedMessageSize="Integer"
           messageEncoding="Text/Mtom"
           name="string"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
           transactionFlow="Boolean"
           useDefaultWebProxy="Boolean">
    <reliableSession ordered="Boolean"
                     inactivityTimeout="TimeSpan"
                     enabled="Boolean" />
    <security mode="Message/None/Transport/TransportWithCredential">
      <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
                 proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                 realm="string" />
      <message algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
               clientCredentialType="Certificate/IssuedToken/None/UserName/Windows"
               establishSecurityContext="Boolean"
               negotiateServiceCredential="Boolean" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</wsHttpBinding>

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

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

Attributes

Свойство	Description
allowCookies	Логическое значение, указывающее, принимает ли клиент файлы cookie и распространяет их на будущие запросы. Значение по умолчанию — false. Это свойство можно использовать при взаимодействии с веб-службами ASMX, которые используют файлы cookie. Таким образом, вы можете убедиться, что файлы cookie, возвращенные с сервера, автоматически копируются во все будущие клиентские запросы для этой службы.
bypassProxyOnLocal	Логическое значение, указывающее, следует ли обходить прокси-сервер для локальных адресов. Значение по умолчанию — false.
closeTimeout	TimeSpan Значение, указывающее интервал времени, предоставленный для завершения операции закрытия. Это значение должно быть больше или равно Zero. Значение по умолчанию — 00:01:00.
hostnameComparisonMode	Указывает режим сравнения имен узла HTTP, используемый для синтаксического анализа URI. Этот атрибут имеет тип HostNameComparisonMode, который указывает, используется ли имя узла для достижения службы при сопоставлении с URI. Значение по умолчанию, StrongWildcardкоторое игнорирует имя узла в совпадении.
maxBufferPoolSize	Целое число, указывающее максимальный размер буферного пула для этой привязки. Значение по умолчанию — 524 288 байт (512 * 1024). Во многих частях Windows Communication Foundation (WCF) используются буферы. Создание и уничтожение буферов каждый раз, когда они используются, является дорогостоящим, а сбор мусора для буферов также является дорогостоящим. С помощью буферных пулов можно взять буфер из пула, использовать его и вернуть его в пул после завершения. Таким образом, не требуется затраты на создание и уничтожение буферов.
maxReceivedMessageSize	Положительное целое число, указывающее максимальный размер сообщения в байтах, включая заголовки, которые можно получить на канале, настроенном с этой привязкой. Отправитель сообщения, превышающего это ограничение, получит ошибку SOAP. Получатель удаляет сообщение и создает запись события в журнале трассировки. Значение по умолчанию — 65536.
messageEncoding	Определяет кодировщик, используемый для кодирования сообщения. Допустимые значения включают следующие значения: — Текст: используйте кодировщик текстовых сообщений. — Mtom: используйте кодировщик организации передачи сообщений 1.0 (MTOM). — Значение по умолчанию — Text. Этот атрибут имеет тип WSMessageEncoding.
имя	Строка, содержащая имя конфигурации привязки. Это значение должно быть уникальным, так как оно используется в качестве идентификации привязки. Начиная с .NET Framework 4 привязки и поведение не требуются для имени. Дополнительные сведения о конфигурации по умолчанию и безымяных привязках и поведении см. в статье "Упрощенная конфигурация " и "Упрощенная конфигурация" для служб WCF.
openTimeout	TimeSpan Значение, указывающее интервал времени, предоставленного для завершения операции открытия. Это значение должно быть больше или равно Zero. Значение по умолчанию — 00:01:00.
proxyAddress	Универсальный код ресурса (URI), указывающий адрес прокси-сервера HTTP. В useSystemWebProxy противном случае trueэтот параметр должен быть null. Значение по умолчанию — null.
receiveTimeout	TimeSpan Значение, указывающее интервал времени, предоставленного для завершения операции получения. Это значение должно быть больше или равно Zero. Значение по умолчанию — 00:01:00.
sendTimeout	TimeSpan Значение, указывающее интервал времени, предоставленного для завершения операции отправки. Это значение должно быть больше или равно Zero. Значение по умолчанию — 00:01:00.
textEncoding	Указывает кодировку набора символов, которая будет использоваться для создания сообщений в привязке. Допустимые значения включают следующие значения: - ЮникодFffeTextEncoding: кодировка Unicode BigEndian. — Utf16TextEncoding: 16-разрядная кодировка. — Utf8TextEncoding: 8-разрядная кодировка. Значение по умолчанию — Utf8TextEncoding. Этот атрибут имеет тип Encoding.
transactionFlow	Логическое значение, указывающее, поддерживает ли привязка поток WS-Transactions. Значение по умолчанию — false.
useDefaultWebProxy	Логическое значение, указывающее, используется ли автоматически настроенный HTTP-прокси системы. Значение по умолчанию — true.

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

Элемент	Description
<безопасность>	Определяет параметры безопасности для привязки. Этот элемент имеет тип WSHttpSecurityElement.
<readerQuotas>	Определяет ограничения сложности сообщений SOAP, которые могут обрабатываться конечными точками, настроенными с помощью этой привязки. Этот элемент имеет тип XmlDictionaryReaderQuotasElement.
<reliableSession>	Указывает, установлены ли надежные сеансы между конечными точками канала.

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

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

Замечания

Он WSHttpBinding аналогичен, BasicHttpBinding но предоставляет дополнительные возможности веб-службы. Он использует транспорт HTTP и обеспечивает безопасность сообщений, как и BasicHttpBinding, но также предоставляет транзакции, надежную передачу сообщений и WS-Адресацию, включенную по умолчанию или доступную с помощью одного параметра управления.

Example

<configuration>
  <system.ServiceModel>
    <bindings>
      <wsHttpBinding>
        <binding closeTimeout="00:00:10"
                 openTimeout="00:00:20"
                 receiveTimeout="00:00:30"
                 sendTimeout="00:00:40"
                 bypassProxyOnLocal="false"
                 transactionFlow="false"
                 hostNameComparisonMode="WeakWildcard"
                 maxReceivedMessageSize="1000"
                 messageEncoding="Mtom"
                 proxyAddress="http://foo/bar"
                 textEncoding="utf-16"
                 useDefaultWebProxy="false">
          <reliableSession ordered="false"
                           inactivityTimeout="00:02:00"
                           enabled="true" />
          <security mode="Transport">
            <transport clientCredentialType="Digest"
                       proxyCredentialType="None"
                       realm="someRealm" />
            <message clientCredentialType="Windows"
                     negotiateServiceCredential="false"
                     algorithmSuite="Aes128"
                     defaultProtectionLevel="None" />
          </security>
        </binding>
      </wsHttpBinding>
    </bindings>
  </system.ServiceModel>
</configuration>

См. также

• WSHttpBinding
• WSHttpBindingElement
• Привязки
• Настройка привязок System-Provided
• использование привязок для настройки служб и клиентов
• <связывание>