<webHttpBinding>

Определяет элемент привязки, используемый для настройки конечных точек для веб-служб Windows Communication Foundation (WCF), которые отвечают на запросы HTTP, а не сообщения SOAP.Defines a binding element that is used to configure endpoints for Windows Communication Foundation (WCF) Web services that respond to HTTP requests instead of SOAP messages.

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

СинтаксисSyntax

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

В следующих разделах описываются атрибуты, дочерние и родительские элементы.The following sections describe attributes, child elements, and parent elements

АтрибутыAttributes

АтрибутAttribute ОписаниеDescription
allowCookiesallowCookies Логическое значение, определяющее, принимает ли клиент файлы Cookie и распространяет ли он их на будущие запросы.A Boolean value that indicates whether the client accepts cookies and propagates them on future requests. Значение по умолчанию – false.The default is false.

Это свойство можно использовать при взаимодействии с веб-службами ASMX, которые используют файлы Cookie.You can use this property when you interact with ASMX Web services that use cookies. В этом случае можно быть уверенным, что файлы cookie, возвращаемые с сервера, автоматически копируются во все последующие клиентские запросы к этой службе.In this way, you can be sure that the cookies returned from the server are automatically copied to all future client requests for that service.
bypassProxyOnLocalbypassProxyOnLocal Логическое значение, определяющее, будет ли выполняться обход прокси-сервера для локальных адресов.A Boolean value that indicates whether to bypass the proxy server for local addresses. Значение по умолчанию — false.The default is false.
closeTimeoutcloseTimeout Значение TimeSpan, которое задает длительность времени ожидания для завершения операции закрытия.A TimeSpan value that specifies the interval of time provided for a close operation to complete. Это значение должно быть больше или равно Zero.This value should be greater than or equal to Zero. Значение по умолчанию - 00:01:00.The default is 00:01:00.
hostnameComparisonModehostnameComparisonMode Задает режим сравнения имен узлов HTTP для анализа универсальных кодов ресурсов (URI).Specifies the HTTP hostname comparison mode used to parse URIs. Это атрибут типа HostNameComparisonMode, который указывает, используется ли имя узла для доступа к службе при сравнении по универсальному коду ресурсов (URI).This attribute is of type HostNameComparisonMode, which indicates whether the hostname is used to reach the service when matching on the URI. Значение по умолчанию — StrongWildcard, при котором имя узла в найденном соответствии не используется.The default value is StrongWildcard, which ignores the hostname in the match.
maxBufferPoolSizemaxBufferPoolSize Целое число, задающее максимальный размер буферного пула для этой привязки.An integer that specifies the maximum buffer pool size for this binding. Значение по умолчанию - 524 288 байт (512 * 1024).The default is 524,288 bytes (512 * 1024). Многие элементы Windows Communication Foundation (WCF) используют буферы.Many parts of Windows Communication Foundation (WCF) use buffers. При создании буферов и их уничтожении после каждого использования расходуется слишком много ресурсов; при сборке мусора для буферов также расходуется слишком много ресурсов.Creating and destroying buffers each time they are used is expensive, and garbage collection for buffers is also expensive. Буферные пулы позволяют брать буфер из пула, использовать его, а затем возвращать обратно, когда он больше не требуется.With buffer pools, you can take a buffer from the pool, use it, and return it to the pool once you are done. Это позволяет избежать излишней нагрузки, связанной с созданием и уничтожением буферов.Thus the overhead in creating and destroying buffers is avoided.
maxBufferSizemaxBufferSize Целое число, задающее максимальный объем памяти, выделяемый для диспетчера буферов сообщений, получающих сообщения из канала.An integer that specifies the maximum amount of memory that is allocated for use by the manager of the message buffers that receive messages from the channel. Значение по умолчанию - 524 288 (0x80 000) байт.The default value is 524,288 (0x80000) bytes.
maxReceivedMessageSizemaxReceivedMessageSize Положительное целое число, задающее, в байтах, максимальный размер сообщения (включая заголовки), которое можно получить по каналу, настроенному с использованием этой привязки.A positive integer that specifies the maximum message size, in bytes, including headers, that can be received on a channel configured with this binding. Отправитель сообщения, которое превысит это ограничение, получит ошибку.The sender of a message exceeding this limit will receive a fault. Получатель отклоняет сообщение и создает запись о событии в журнале трассировки.The receiver drops the message and creates an entry of the event in the trace log. Значение по умолчанию — 65536.The default is 65536. Примечание. Увеличение этого значения недостаточно в режиме совместимости с ASP.NET.Note: Increasing this value alone is not sufficient in ASP.NET compatible mode. Также следует увеличить значение httpRuntime (см. элемент httpRuntime (схема параметров ASP.NET)).You should also increase the value of httpRuntime (see httpRuntime Element (ASP.NET Settings Schema)).
namename Строка, содержащая имя конфигурации привязки.A string that contains the configuration name of the binding. Это значение должно быть уникальным, поскольку оно используется в качестве идентификатора привязки.This value should be unique because it is used as an identification for the binding. Начиная с платформа .NET Framework 4, привязки и поведения не обязательно должны иметь имя.Starting with .NET Framework 4, bindings and behaviors are not required to have a name. Дополнительные сведения о конфигурации по умолчанию и привязках и поведении, которые не имеют имен, см. в разделе упрощенная конфигурация и упрощенная конфигурация для служб WCF.For more information about default configuration and nameless bindings and behaviors, see Simplified Configuration and Simplified Configuration for WCF Services.
openTimeoutopenTimeout Значение TimeSpan, которое задает длительность времени ожидания для завершения операции открытия.A TimeSpan value that specifies the interval of time provided for an open operation to complete. Это значение должно быть больше или равно Zero.This value should be greater than or equal to Zero. Значение по умолчанию - 00:01:00.The default is 00:01:00.
proxyAddressproxyAddress Универсальный код ресурса (URI), задающий адрес прокси-сервера HTTP.A URI that specifies the address of the HTTP proxy. Если параметр useSystemWebProxy имеет значение true, данный параметр должен иметь значение null.If useSystemWebProxy is true, this setting must be null. Значение по умолчанию — null.The default is null.
receiveTimeoutreceiveTimeout Значение TimeSpan, которое задает длительность времени ожидания для завершения операции получения.A TimeSpan value that specifies the interval of time provided for a receive operation to complete. Это значение должно быть больше или равно Zero.This value should be greater than or equal to Zero. Значение по умолчанию - 00:01:00.The default is 00:01:00.
sendTimeoutsendTimeout Значение TimeSpan, которое задает длительность времени ожидания для завершения операции отправки.A TimeSpan value that specifies the interval of time provided for a send operation to complete. Это значение должно быть больше или равно Zero.This value should be greater than or equal to Zero. Значение по умолчанию - 00:01:00.The default is 00:01:00.
transferMode.transferMode. Значение TransferMode, которое определяет, используется ли службой, настроенной с помощью привязки, потоковый или буферный режим (или оба режима) передачи сообщений.A TransferMode value that indicates whether the service configured with the binding uses streamed or buffered (or both) modes of message transfer. Значение по умолчанию — Buffered.The default is Buffered.
useDefaultWebProxyuseDefaultWebProxy Логическое значение, определяющее, должен ли использоваться автоматически настроенный системный прокси-сервер HTTP.A Boolean value that specifies whether the system’s auto-configured HTTP proxy is used. Значение по умолчанию — true.The default is true.
writeEncodingwriteEncoding Задает кодировку, используемую в тексте сообщений.Specifies the character encoding that is used for the message text. Допустимые значения.Valid values include the following:

UnicodeFffeTextEncoding: кодировка Юникод (обратный порядок байтов).UnicodeFffeTextEncoding: Unicode BigEndian encoding.

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

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

Значение по умолчанию - Utf8TextEncoding.The default is Utf8TextEncoding.

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

ЭлементElement ОписаниеDescription
<readerQuotas> Определяет ограничения по сложности сообщений POX, которые могут обрабатываться конечными точками, настроенными с помощью этой привязки.Defines the constraints on the complexity of POX messages that can be processed by endpoints configured with this binding. Это элемент типа XmlDictionaryReaderQuotasElement.This element is of type XmlDictionaryReaderQuotasElement.
<security> Определяет параметры безопасности привязки.Defines the security settings for the binding. Это элемент типа WebHttpSecurityElement.This element is of type WebHttpSecurityElement.

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

ЭлементElement ОписаниеDescription
<bindings> Этот элемент содержит коллекцию стандартных и пользовательских привязок.This element holds a collection of standard and custom bindings.

RemarksRemarks

Модель веб-программирования WCF позволяет разработчикам предоставлять веб-службы WCF с помощью запросов HTTP, в которых вместо обмена сообщениями на основе SOAP используется обычный формат XML (POX).The WCF Web Programming Model allows developers to expose WCF Web services through HTTP requests that use "plain old XML" (POX) style messaging instead of SOAP-based messaging. Чтобы клиенты могли взаимодействовать со службой с помощью HTTP-запросов, конечная точка службы должна быть настроена с тем <webHttpBinding> , к которому <WebHttpBehavior> присоединена эта служба.For clients to communicate with a service using HTTP requests, an endpoint of the service must be configured with the <webHttpBinding> that has the <WebHttpBehavior> attached to it.

Поддержка в WCF для синдикации и ASP. Интеграция с AJAX построена на основе модели веб-программирования.Support in WCF for syndication and ASP.AJAX integration are both built on top of the Web Programming Model. Дополнительные сведения о модели см. в разделе модель программирования WCF Web HTTP.For more information on the model, see WCF Web HTTP Programming Model.

См. такжеSee also