<webHttpBinding>

Define um elemento de associação que é usado para configurar pontos de extremidade para serviços da Web Windows Communication Foundation (WCF) que respondem a solicitações HTTP em vez de mensagens 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>

SyntaxSyntax

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

Atributos e elementosAttributes and Elements

As seções a seguir descrevem atributos, elementos filho e elementos paiThe following sections describe attributes, child elements, and parent elements

AtributosAttributes

AtributoAttribute DescriçãoDescription
allowCookiesallowCookies Um valor booliano que indica se o cliente aceita cookies e os propaga em solicitações futuras.A Boolean value that indicates whether the client accepts cookies and propagates them on future requests. O padrão é falso.The default is false.

Você pode usar essa propriedade ao interagir com serviços Web ASMX que usam cookies.You can use this property when you interact with ASMX Web services that use cookies. Dessa forma, você pode ter certeza de que os cookies retornados do servidor são copiados automaticamente para todas as solicitações de cliente futuras para esse serviço.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 Um valor booliano que indica se deve ignorar o servidor proxy para endereços locais.A Boolean value that indicates whether to bypass the proxy server for local addresses. O padrão é false.The default is false.
closeTimeoutcloseTimeout Um TimeSpan valor que especifica o intervalo de tempo fornecido para a conclusão de uma operação de fechamento.A TimeSpan value that specifies the interval of time provided for a close operation to complete. Esse valor deve ser maior ou igual a Zero .This value should be greater than or equal to Zero. O padrão é 00:01:00.The default is 00:01:00.
hostnameComparisonModehostnameComparisonMode Especifica o modo de comparação de nome de host HTTP usado para analisar URIs.Specifies the HTTP hostname comparison mode used to parse URIs. Esse atributo é do tipo HostNameComparisonMode , que indica se o nome do host é usado para acessar o serviço ao corresponder ao URI.This attribute is of type HostNameComparisonMode, which indicates whether the hostname is used to reach the service when matching on the URI. O valor padrão é StrongWildcard , que ignora o nome do host na correspondência.The default value is StrongWildcard, which ignores the hostname in the match.
maxBufferPoolSizemaxBufferPoolSize Um inteiro que especifica o tamanho máximo do pool de buffers para essa associação.An integer that specifies the maximum buffer pool size for this binding. O padrão é 524.288 bytes (512 * 1024).The default is 524,288 bytes (512 * 1024). Muitas partes de Windows Communication Foundation (WCF) usam buffers.Many parts of Windows Communication Foundation (WCF) use buffers. Criar e destruir buffers cada vez que eles são usados é caro, e a coleta de lixo para buffers também é dispendiosa.Creating and destroying buffers each time they are used is expensive, and garbage collection for buffers is also expensive. Com os pools de buffers, você pode pegar um buffer do pool, usá-lo e retorná-lo ao pool quando terminar.With buffer pools, you can take a buffer from the pool, use it, and return it to the pool once you are done. Portanto, a sobrecarga na criação e na destruição de buffers é evitada.Thus the overhead in creating and destroying buffers is avoided.
maxBufferSizemaxBufferSize Um inteiro que especifica a quantidade máxima de memória alocada para uso pelo Gerenciador dos buffers de mensagens que recebem mensagens do canal.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. O valor padrão é 524.288 (0x80000) bytes.The default value is 524,288 (0x80000) bytes.
maxReceivedMessageSizemaxReceivedMessageSize Um inteiro positivo que especifica o tamanho máximo da mensagem, em bytes, incluindo cabeçalhos, que pode ser recebido em um canal configurado com essa associação.A positive integer that specifies the maximum message size, in bytes, including headers, that can be received on a channel configured with this binding. O remetente de uma mensagem que excede esse limite receberá uma falha.The sender of a message exceeding this limit will receive a fault. O receptor remove a mensagem e cria uma entrada do evento no log de rastreamento.The receiver drops the message and creates an entry of the event in the trace log. O padrão é 65536.The default is 65536. Observação: Aumentar este valor sozinho não é suficiente no modo compatível com ASP.NET.Note: Increasing this value alone is not sufficient in ASP.NET compatible mode. Você também deve aumentar o valor de httpRuntime (consulte o elemento httpRuntime (esquema de configurações de ASP.net)).You should also increase the value of httpRuntime (see httpRuntime Element (ASP.NET Settings Schema)).
namename Uma cadeia de caracteres que contém o nome da configuração da associação.A string that contains the configuration name of the binding. Esse valor deve ser exclusivo porque é usado como uma identificação para a associação.This value should be unique because it is used as an identification for the binding. A partir do .NET Framework 4, associações e comportamentos não precisam ter um nome.Starting with .NET Framework 4, bindings and behaviors are not required to have a name. Para obter mais informações sobre configurações padrão e associações e comportamentos do sem nome, consulte configuração simplificada e configuração simplificada para serviços WCF.For more information about default configuration and nameless bindings and behaviors, see Simplified Configuration and Simplified Configuration for WCF Services.
openTimeoutopenTimeout Um TimeSpan valor que especifica o intervalo de tempo fornecido para a conclusão de uma operação de abertura.A TimeSpan value that specifies the interval of time provided for an open operation to complete. Esse valor deve ser maior ou igual a Zero .This value should be greater than or equal to Zero. O padrão é 00:01:00.The default is 00:01:00.
proxyAddressproxyAddress Um URI que especifica o endereço do proxy HTTP.A URI that specifies the address of the HTTP proxy. Se useSystemWebProxy for true , essa configuração deverá ser null .If useSystemWebProxy is true, this setting must be null. O padrão é null.The default is null.
receiveTimeoutreceiveTimeout Um TimeSpan valor que especifica o intervalo de tempo fornecido para a conclusão de uma operação de recebimento.A TimeSpan value that specifies the interval of time provided for a receive operation to complete. Esse valor deve ser maior ou igual a Zero .This value should be greater than or equal to Zero. O padrão é 00:01:00.The default is 00:01:00.
sendTimeoutsendTimeout Um TimeSpan valor que especifica o intervalo de tempo fornecido para a conclusão de uma operação de envio.A TimeSpan value that specifies the interval of time provided for a send operation to complete. Esse valor deve ser maior ou igual a Zero .This value should be greater than or equal to Zero. O padrão é 00:01:00.The default is 00:01:00.
TransferMode.transferMode. Um TransferMode valor que indica se o serviço configurado com a associação usa modos de fluxo ou em buffer (ou ambos) de transferência de mensagem.A TransferMode value that indicates whether the service configured with the binding uses streamed or buffered (or both) modes of message transfer. O padrão é Buffered.The default is Buffered.
useDefaultWebProxyuseDefaultWebProxy Um valor booliano que especifica se o proxy HTTP autoconfigurado do sistema é usado.A Boolean value that specifies whether the system’s auto-configured HTTP proxy is used. O padrão é true.The default is true.
writeEncodingwriteEncoding Especifica a codificação de caracteres usada para o texto da mensagem.Specifies the character encoding that is used for the message text. Os valores válidos incluem os seguintes:Valid values include the following:

UnicodeFffeTextEncoding: codificação BigEndian Unicode.UnicodeFffeTextEncoding: Unicode BigEndian encoding.

Utf16TextEncoding: codificação de 16 bits.Utf16TextEncoding: 16-bit encoding.

Utf8TextEncoding: codificação de 8 bits.Utf8TextEncoding: 8-bit encoding.

O padrão é Utf8TextEncoding.The default is Utf8TextEncoding.

Elementos filhoChild Elements

ElementoElement DescriçãoDescription
<readerQuotas> Define as restrições sobre a complexidade de mensagens POX que podem ser processadas por pontos de extremidade configurados com essa associação.Defines the constraints on the complexity of POX messages that can be processed by endpoints configured with this binding. Esse elemento é do tipo XmlDictionaryReaderQuotasElement .This element is of type XmlDictionaryReaderQuotasElement.
<security> Define as configurações de segurança para a associação.Defines the security settings for the binding. Esse elemento é do tipo WebHttpSecurityElement .This element is of type WebHttpSecurityElement.

Elementos paiParent Elements

ElementoElement DescriçãoDescription
<bindings> Esse elemento contém uma coleção de associações padrão e personalizadas.This element holds a collection of standard and custom bindings.

ComentáriosRemarks

O modelo de programação Web do WCF permite que os desenvolvedores exponham os serviços Web WCF por meio de solicitações HTTP que usam mensagens de estilo "de" XML antigo "(POX) em vez de mensagens baseadas em SOAP.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. Para que os clientes se comuniquem com um serviço usando solicitações HTTP, um ponto de extremidade do serviço deve ser configurado com o <webHttpBinding> que está <WebHttpBehavior> anexado a ele.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.

Suporte no WCF para distribuição e ASP. A integração do AJAX é criada com base no modelo de programação da Web.Support in WCF for syndication and ASP.AJAX integration are both built on top of the Web Programming Model. Para obter mais informações sobre o modelo, consulte modelo de programação do WCF Web http.For more information on the model, see WCF Web HTTP Programming Model.

Consulte tambémSee also