Partilhar via

<webHttpBinding>

Define um elemento de ligação que é usado para configurar endpoints para serviços Web do Windows Communication Foundation (WCF) que respondem a pedidos HTTP em vez de mensagens SOAP.

<configuração>
   <system.serviceModel>
     <Encadernações>
       <webHttpBinding>

Sintaxe

<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 atributos, elementos filho e elementos pai

Attributes

Attribute Description
allowCookies Um valor booleano que indica se o cliente aceita cookies e propaga-os em pedidos futuros. O padrão é "false".

Pode usar esta propriedade quando interage com serviços Web ASMX que utilizam cookies. Desta forma, pode ter a certeza de que os cookies devolvidos pelo servidor são automaticamente copiados para todos os pedidos futuros dos clientes para esse serviço.
bypassProxyOnLocal Um valor booleano que indica se deve contornar o servidor proxy para endereços locais. A predefinição é false.
closeTimeout Um TimeSpan valor que especifica o intervalo de tempo fornecido para a conclusão de uma operação de fechamento. Este valor deve ser maior ou igual a Zero. O padrão é 00:01:00.
Modo de Comparação Nome do Host Especifica o modo de comparação de nomes de host HTTP usado para analisar URIs. Este atributo é do tipo HostNameComparisonMode, que indica se o nome de host é usado para aceder ao serviço quando corresponde no URI. O valor padrão é StrongWildcard, que ignora o nome do host na correspondência.
maxBufferPoolSize Um inteiro que especifica o tamanho máximo do buffer pool para esta ligação. O padrão é 524.288 bytes (512 * 1024). Muitas partes do Windows Communication Foundation (WCF) utilizam buffers. Criar e destruir buffers sempre que são usados é caro, e a recolha de lixo para buffers também é dispendiosa. Com os buffer pools, podes pegar num buffer do pool, usá-lo e devolvê-lo ao pool quando terminares. Assim, evita-se a sobrecarga na criação e destruição de tampões.
maxBufferSize Um inteiro que especifica a quantidade máxima de memória alocada para uso pelo gestor 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 num canal configurado com esta ligação. O remetente de uma mensagem que ultrapasse este limite receberá uma falha. O recetor elimina a mensagem e cria uma entrada do evento no registo de rastreamento. O padrão é 65536. Nota: Aumentar este valor sozinho não é suficiente no modo ASP.NET compatível. Deves também aumentar o valor de httpRuntime (ver httpRuntime Element (ASP.NET Settings Schema)).
nome Uma cadeia que contém o nome da configuração da ligação. Este valor deve ser único porque é usado como identificação da ligação. A partir do .NET Framework 4, os bindings e comportamentos não são obrigatórios de ter um nome. Para mais informações sobre configuração padrão e ligações e comportamentos sem nome, consulte Configuração Simplificada e Configuração Simplificada para Serviços WCF.
openTimeout Um TimeSpan valor que especifica o intervalo de tempo previsto para que uma operação aberta seja concluída. Este valor deve ser maior ou igual a Zero. O padrão é 00:01:00.
Proxy Address Um URI que especifica o endereço do proxy HTTP. Se useSystemWebProxy for true, esta definição deve ser null. A predefinição é null.
receiveTimeout Um TimeSpan valor que especifica o intervalo de tempo fornecido para a conclusão de uma operação de receção. Este valor deve ser maior ou igual a Zero. O padrão é 00:01:00.
enviarTempo de espera Um TimeSpan valor que especifica o intervalo de tempo fornecido para que uma operação de envio seja concluída. Este valor deve ser maior ou igual a Zero. O padrão é 00:01:00.
TransferMode. Um TransferMode valor que indica se o serviço configurado com a ligação utiliza modos de transferência de mensagens em fluxo ou buffer (ou ambos). A predefinição é Buffered.
useDefaultWebProxy Um valor booleano que especifica se o proxy HTTP auto-configurado do sistema é utilizado. A predefiniçã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 Description
<LeitorQuotas> Define as restrições à complexidade das mensagens POX que podem ser processadas por endpoints configurados com esta ligação. Este elemento é do tipo XmlDictionaryReaderQuotasElement.
<Segurança> Define as definições de segurança para a ligação. Este elemento é do tipo WebHttpSecurityElement.

Elementos Principais

Elemento Description
<Encadernações> Este elemento contém uma coleção de encadernações padrão e personalizadas.

Observações

O Modelo de Programação Web WCF permite aos programadores expor serviços Web WCF através de pedidos HTTP que utilizam mensagens ao estilo "simples e XML" (POX) em vez de mensagens baseadas em SOAP. Para que os clientes possam comunicar com um serviço usando pedidos HTTP, um endpoint do serviço deve ser configurado com o <webHttpBinding> que tem o <WebHttpBehavior> associado.

Suporte na WCF para sindicância e ASP. A integração com AJAX é construída sobre o Modelo de Programação Web. Para mais informações sobre o modelo, veja Modelo de Programação HTTP Web WCF.

Consulte também

  • Last updated on