<webHttpBinding>

Определяет элемент привязки, используемый для настройки конечных точек для веб-служб Windows Communication Foundation (WCF), которые отвечают на HTTP-запросы вместо сообщений SOAP.

<configuration>
  <system.serviceModel>
    <bindings>
      <webHttpBinding>

Синтаксис

<webHttpBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="integer"
           maxBufferSize="integer"
           maxReceivedMessageSize="Integer"
           name="string"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
           useDefaultWebProxy="Boolean"
           writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding">
    <security mode="None/Transport/TransportCredentialOnly">
      <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
                 proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                 realm="string" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</webHttpBinding>

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

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

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) используются буферы. Создание и уничтожение буферов каждый раз, когда они используются, является дорогостоящим, а сбор мусора для буферов также является дорогостоящим. С помощью буферных пулов можно взять буфер из пула, использовать его и вернуть его в пул после завершения. Таким образом, не требуется затраты на создание и уничтожение буферов.
maxBufferSize Целое число, указывающее максимальное количество памяти, выделенное для использования диспетчером буферов сообщений, получающих сообщения из канала. Значение по умолчанию — 524 288 (0x80000) байтов.
maxReceivedMessageSize Положительное целое число, указывающее максимальный размер сообщения в байтах, включая заголовки, которые можно получить на канале, настроенном с этой привязкой. Отправитель сообщения, превышающего это ограничение, получит ошибку. Получатель удаляет сообщение и создает запись события в журнале трассировки. Значение по умолчанию — 65536. Примечание: Увеличение этого значения недостаточно в режиме совместимости ASP.NET. Также следует увеличить значение httpRuntime (см. элемент httpRuntime (ASP.NET схема параметров)).
имя Строка, содержащая имя конфигурации привязки. Это значение должно быть уникальным, так как оно используется в качестве идентификации привязки. Начиная с .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.
transferMode. TransferMode Значение, указывающее, используется ли служба, настроенная с привязкой, использует потоковый или буферный (или оба) режима передачи сообщений. Значение по умолчанию — Buffered.
useDefaultWebProxy Логическое значение, указывающее, используется ли автоматически настроенный HTTP-прокси системы. Значение по умолчанию — true.
writeEncoding Указывает кодировку символов, используемую для текста сообщения. Допустимые значения включают следующие значения:

ЮникодFffeTextEncoding: кодировка Unicode BigEndian.

Utf16TextEncoding: 16-разрядная кодировка.

Utf8TextEncoding: 8-разрядная кодировка.

Значение по умолчанию — Utf8TextEncoding.

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

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

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

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

Замечания

Модель веб-программирования WCF позволяет разработчикам предоставлять веб-службы WCF через HTTP-запросы, использующие "обычный старый XML" стиль обмена сообщениями вместо обмена сообщениями на основе SOAP. Чтобы клиенты взаимодействовали со службой с помощью HTTP-запросов, конечная точка службы должна быть настроена с <помощью webHttpBinding> с <присоединенным к нему webHttpBehavior> .

Поддержка в WCF для синдикации и ASP. Интеграция AJAX основана на модели веб-программирования. Дополнительные сведения о модели см. в статье WCF Web HTTP Programming Model.

См. также

  • Last updated on