Partilhar via

<basicHttpContextBinding>

Especificar uma ligação que forneça contexto para a BasicHttpBinding troca, ativando cookies HTTP como mecanismo de troca.

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

Sintaxe

<basicHttpContextBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="Integer"
           maxBufferSize="Integer"
           maxReceivedMessageSize="Integer"
           messageEncoding="Text/Mtom"
           name="String"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
           transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
           useDefaultWebProxy="Boolean">
    <security mode="None/Transport/Message/TransportWithMessageCredential/TransportCredentialOnly">
      <transport clientCredentialType="None/Basic/Digest/Ntlm/Windows/Certificate"
                 proxyCredentialType="None/Basic/Digest/Ntlm/Windows"
                 realm="String" />
      <message algorithmSuite="Aes128/Aes192/Aes256/Rsa15Aes128/ Rsa15Aes256/TripleDes"
               clientCredentialType="UserName/Certificate" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</basicHttpContextBinding>

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. A predefiniçã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.

Um recurso da Internet é local se tiver um endereço local. Um endereço local é aquele que se encontra no mesmo computador, na LAN local ou intranet, e é identificado, sintaticamente, pela ausência de ponto (.) como nos URIs http://webserver/ e http://localhost/.

Definir este atributo determina se os endpoints configurados com o BasicHttpBinding utilizam o servidor proxy ao aceder a recursos locais. Se este atributo for true, os pedidos a recursos locais da Internet não utilizam o servidor proxy. Use o nome do host (em vez de localhost) se quiser que os clientes passem por um proxy ao falar com serviços na mesma máquina quando este atributo está definido para true.

Quando este atributo é false, todos os pedidos de Internet são feitos através do servidor proxy.
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.
hostNameComparisonMode 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 valor 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 é 524288 (0x80000) bytes.

O Gestor de Buffers minimiza o custo de utilização de buffers ao utilizar um pool de buffers. Os buffers são obrigados a processar mensagens pelo serviço quando saem do canal. Se não houver memória suficiente no pool de buffers para processar a carga da mensagem, o Gestor de Buffers deve alocar memória adicional do heap CLR, o que aumenta a sobrecarga de recolha de lixo. A alocação extensiva a partir do monte de lixo CLR indica que o tamanho do buffer pool é demasiado pequeno e que o desempenho pode ser melhorado com uma alocação maior aumentando o limite especificado por este atributo.
maxBufferSize Um valor inteiro que especifica o tamanho máximo, em bytes, de um buffer que armazena mensagens enquanto são processadas para um endpoint configurado com esta ligação. O valor padrão é 65.536 bytes.
maxReceivedMessageSize Um inteiro positivo que define o tamanho máximo da mensagem, em bytes, incluindo cabeçalhos, para uma mensagem que pode ser recebida num canal configurado com esta ligação. O emissor recebe uma falha SOAP se a mensagem for demasiado grande para o recetor. O recetor elimina a mensagem e cria uma entrada do evento no registo de rastreamento. O padrão é 65.536 bytes.
messageEncoding Define o codificador usado para codificar a mensagem SOAP. Os valores válidos incluem os seguintes:

- Texto: Use um codificador de mensagens de texto.
- Mtom: Utilizar um codificador Message Transmission Organization Mechanism 1.0 (MTOM).

O padrão é Text. Este atributo é do tipo WSMessageEncoding.
messageVersion Especifica a versão da mensagem usada por clientes e serviços configurados com a ligação. Este atributo é do tipo MessageVersion.
name 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.
proxyAddress Um URI que contém o endereço do proxy HTTP. Se useSystemWebProxy for definido como 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:10:00.
sendTimeout 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.
textEncoding Define a codificação do conjunto de caracteres para ser usada para emitir mensagens na ligação. Os valores válidos incluem os seguintes:

- BigEndianUnicode: Codificação Unicode BigEndian.
- Unicode: codificação de 16 bits.
- UTF8: codificação de 8 bits

O padrão é UTF8. Este atributo é do tipo Encoding.
transferMode Um valor válido TransferMode que especifica se as mensagens são armazenadas em buffer ou transmitidas num pedido ou resposta.
useDefaultWebProxy Um valor booleano que especifica se o proxy HTTP auto-configurado do sistema deve ser utilizado, se disponível. A predefinição é true.

Elementos filho

Elemento Description
<Segurança> Define as definições de segurança para a ligação. Este elemento é do tipo BasicHttpSecurityElement.
<LeitorQuotas> Define as restrições à complexidade das mensagens SOAP que podem ser processadas pelos endpoints configurados com esta ligação. Este elemento é do tipo XmlDictionaryReaderQuotasElement.

Elementos Principais

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

Observações

Este elemento de ligação fornece um nível de proteção e um mecanismo de troca como parte do contexto para um BasicHttpBinding.

Consulte também

  • Last updated on