<webHttpBinding>

Статья
02/28/2011

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

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

<system.serviceModel>
<bindings>
<wsHttpBinding>

Синтаксис

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

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

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

Атрибуты

Атрибут	Описание
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 Element (ASP.NET Settings Schema)).
name	Строка, содержащая имя конфигурации привязки. Это значение должно быть уникальным, поскольку оно используется в качестве идентификатора привязки. Начиная с версии .NET Framework 4 для привязок и поведений необязательно задавать имена. Дополнительные сведения о конфигурации по умолчанию и о безымянных привязках и поведениях см. в разделах Simplified Configuration и Simplified Configuration for WCF Services.
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	Задает кодировку, используемую в тексте сообщений. Допустимы следующие значения: UnicodeFffeTextEncoding: кодировка Юникод (обратный порядок байтов). Utf16TextEncoding: 16-разрядная кодировка. Utf8TextEncoding: 8-разрядная кодировка. Значение по умолчанию — «Utf8TextEncoding».

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

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

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

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

Замечания

Модель веб-программирования WCF позволяет разработчикам предоставлять веб-службы WCF с помощью запросов протокола HTTP, в которых используется стиль «Plain Old XML» (POX) вместо обмена сообщениями на основе протокола SOAP. Чтобы клиенты могли взаимодействовать со службой с помощью HTTP-запросов, конечная точка службы должна быть настроена с использованием привязки <wsHttpBinding><>, к которой присоединено поведение WebHttpBehavior.

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

См. также

Справочник

WebHttpBinding
WebHttpBindingElement

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

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

Web Programming Model
Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients

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