<webHttpBinding>

Artigo
05/09/2023

Define um elemento de associação usado para configurar pontos de extremidade para serviços Web do WCF (Windows Communication Foundation) que respondem a solicitações HTTP em vez de a mensagens SOAP.

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

Atributos e elementos

As seções a seguir descrevem os atributos, os elementos filho e os elementos pai

Atributos

Atributo	Descrição
allowCookies	Um valor booliano que indica se o cliente aceita cookies e os propaga em solicitações futuras. O padrão é falso. Você pode usar essa propriedade ao interagir com os serviços Web ASMX que usam cookies. Dessa forma, você pode ter certeza de que os cookies retornados do servidor são copiados automaticamente para todas as solicitações futuras do cliente para esse serviço.
bypassProxyOnLocal	Um valor booliano que indica se o servidor proxy deve ser ignorado para endereços locais. O padrão é `false`.
closeTimeout	Um valor TimeSpan que especifica o intervalo de tempo para a conclusão de uma operação de fechamento. Esse valor deve ser igual ou superior a Zero. O padrão é 00:01:00.
hostnameComparisonMode	Especifica o modo de comparação de nome do host HTTP usado para analisar URIs. Esse atributo é do tipo HostNameComparisonMode, o que indica se o nome do host é usado para acessar o serviço ao fazer correspondência no URI. O valor padrão é StrongWildcard, o que ignora o nome do host na correspondência.
maxBufferPoolSize	Um inteiro que especifica o tamanho máximo do pool de buffers para essa associação. O padrão é 524.288 bytes (512 * 1024). Muitas partes do WCF (Windows Communication Foundation) usam buffers. Criar e destruir buffers cada vez que eles são usados é caro, e a coleta de lixo para buffers também é cara. Com os pools de buffers, você pode pegar um buffer do pool, usá-lo e devolvê-lo ao pool assim que terminar. Portanto, a sobrecarga na criação e na destruição de buffers é evitada.
maxBufferSize	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. O valor padrão é 524.288 (0x80000) bytes.
maxReceivedMessageSize	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. O remetente de uma mensagem que exceder esse limite receberá uma falha. O destinatário remove a mensagem e cria uma entrada do evento no log de rastreamento. O padrão é 65.536. Observação: o aumento desse valor sozinho não é suficiente no modo compatível com o ASP.NET. Você também deve aumentar o valor de `httpRuntime` (confira Elemento httpRuntime (esquema de configurações do ASP.NET)).
name	Uma cadeia de caracteres que contém o nome de configuração da associação. Esse valor deve ser exclusivo, pois é usado como uma identificação para a associação. A partir do .NET Framework 4, associações e comportamentos não precisam ter um nome. Para obter mais informações sobre a configuração padrão e as associações sem nome, incluindo os comportamentos, confira Configuração Simplificada e Configuração Simplificada para Serviços WCF.
openTimeout	Um valor TimeSpan que especifica o intervalo de tempo fornecido para a conclusão de uma operação de abertura. Esse valor deve ser igual ou superior a Zero. O padrão é 00:01:00.
proxyAddress	Um URI que especifica o endereço do proxy HTTP. Se `useSystemWebProxy` for `true`, essa configuração precisará ser `null`. O padrão é `null`.
receiveTimeout	Um valor TimeSpan que especifica o intervalo de tempo para a conclusão de uma operação de recebimento. Esse valor deve ser igual ou superior a Zero. O padrão é 00:01:00.
sendTimeout	Um valor TimeSpan que especifica o intervalo de tempo para a conclusão de uma operação de envio. Esse valor deve ser igual ou superior a Zero. O padrão é 00:01:00.
transferMode.	Um valor TransferMode que indica se o serviço configurado com a associação usa os modos de transferência de mensagens por transmissão e/ou armazenamento em buffer. O padrão é `Buffered`.
useDefaultWebProxy	Um valor booliano que especifica se o proxy HTTP configurado automaticamente do sistema é usado. O padrão é `true`.
writeEncoding	Especifica a codificação de caracteres usada para o texto da mensagem. Os valores válidos incluem os seguintes: UnicodeFffeTextEncoding: codificação Unicode BigEndian. Utf16TextEncoding: codificação de 16 bits. Utf8TextEncoding: codificação de 8 bits. O padrão é Utf8TextEncoding.

Elementos filho

Elemento	Descrição
<readerQuotas>	Define as restrições sobre a complexidade das mensagens SOAP que podem ser processadas por pontos de extremidade configurados com essa associação. Esse elemento é do tipo XmlDictionaryReaderQuotasElement.
<security>	Define as configurações de segurança da associação. Esse elemento é do tipo WebHttpSecurityElement.

Elementos pai

Elemento	Descrição
<bindings>	Esse elemento contém uma coleção de associações padrão e personalizadas.

Comentários

O Modelo de Programação Web do WCF permite que os desenvolvedores exponham serviços Web do WCF por meio de solicitações HTTP que usam mensagens de estilo POX ("XML básico") em vez de mensagens baseadas em SOAP. Para que os clientes se comuniquem com um serviço usando solicitações HTTP, um ponto de extremidade do serviço precisa ser configurado com a <webHttpBinding> que tenha o <WebHttpBehavior> anexado.

O suporte à sindicalização e à integração do ASP.AJAX no WCF foi criado com base no Modelo de Programação da Web. Para obter mais informações sobre o modelo, confira Modelo de Programação HTTP da Web do WCF.

Compartilhar via