Compartilhar via

<basicHttpContextBinding>

Especificando uma associação que fornece contexto para a BasicHttpBinding troca, habilitando cookies HTTP como o mecanismo de troca.

<configuração>
   <system.serviceModel>
     <Ligaçõ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 booliano que indica se o cliente aceita cookies e os propaga em solicitações futuras. O padrão é false.

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 automaticamente copiados 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.

Um recurso da Internet será local se tiver um endereço local. Um endereço local é aquele que está no mesmo computador, lan local ou intranet e é identificado, sintaticamente, pela falta de um período (.) como nos URIs http://webserver/ e http://localhost/.

Definir esse atributo determina se os pontos de extremidade configurados com o BasicHttpBinding usam o servidor proxy ao acessar recursos locais. Se esse atributo for true, as solicitações aos recursos locais da Internet não usarão 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 no mesmo computador quando esse atributo for definido como true.

Quando esse atributo é false, todas as solicitações da Internet são feitas por meio do servidor proxy.
closeTimeout Um TimeSpan valor que especifica o intervalo de tempo fornecido para que uma operação de fechamento seja concluída. Esse valor deve ser maior ou igual a Zero. O padrão é 00:01:00.
hostNameComparisonMode Especifica o modo de comparação de nome de host HTTP usado para analisar URIs. Esse atributo é do tipo HostNameComparisonMode, que indica se o nome do host é usado para alcançar o serviço ao corresponder 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 gerente dos buffers de mensagem que recebem mensagens do canal. O valor padrão é 524288 (0x80000) bytes.

O Gerenciador de Buffers minimiza o custo do uso de buffers usando um pool de buffers. Os buffers são necessários para processar mensagens pelo serviço quando elas saem do canal. Se não houver memória suficiente no pool de buffers para processar a carga da mensagem, o Gerenciador de Buffers deverá alocar memória adicional do heap CLR, o que aumenta a sobrecarga da coleta de lixo. A alocação abrangente do heap de lixo CLR é uma indicação de que o tamanho do pool de buffers é muito pequeno e que o desempenho pode ser melhorado com uma alocação maior aumentando o limite especificado por esse 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 ponto de extremidade configurado com essa associaçã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 em um canal configurado com essa associação. O remetente receberá uma falha SOAP se a mensagem for muito grande para o receptor. O receptor descarta a mensagem e cria uma entrada do evento no log de rastreamento. O padrão é 65.536 bytes.
messageEncoding Define o codificador usado para codificar a mensagem SOAP. Os valores válidos incluem o seguinte:

- Texto: usar um codificador de mensagem de texto.
- Mtom: use um codificador MTOM (Mecanismo de Organização de Transmissão de Mensagens 1.0).

O padrão é Texto. Esse atributo é do tipo WSMessageEncoding.
messageVersion Especifica a versão da mensagem usada por clientes e serviços configurados com a associação. Esse atributo é do tipo MessageVersion.
name Uma cadeia de caracteres que contém o nome de configuração da associação. Esse valor deve ser exclusivo porque é usado como uma identificação para a associação. A partir do .NET Framework 4, associações e comportamentos não são necessários para ter um nome. Para obter mais informações sobre configuração padrão e associaçõ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 fornecido para uma operação aberta ser concluída. Esse 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 estiver definido como true, essa configuração deverá ser null. O padrão é null.
receiveTimeout Um TimeSpan valor que especifica o intervalo de tempo fornecido para a conclusão de uma operação de recebimento. Esse 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 a conclusão de uma operação de envio. Esse valor deve ser maior ou igual a Zero. O padrão é 00:01:00.
textEncoding Define a codificação do conjunto de caracteres a ser usada para emitir mensagens na associação. Os valores válidos incluem o seguinte:

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

O padrão é UTF8. Esse atributo é do tipo Encoding.
transferMode Um valor válido TransferMode que especifica se as mensagens são armazenadas em buffer ou transmitidas em uma solicitação ou resposta.
useDefaultWebProxy Um valor booliano que especifica se o proxy HTTP configurado automaticamente do sistema deve ser usado, se disponível. O padrão é true.

Elementos filho

Elemento Description
<segurança> Define as configurações de segurança para a associação. Esse elemento é do tipo BasicHttpSecurityElement.
<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.

Elementos pai

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

Observações

Esse elemento de associaçã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