<basicHttpContextBinding>

Artigo
05/10/2023

Especificando uma associação que fornece contexto para que a BasicHttpBinding seja trocada pela habilitação de cookies HTTP como o mecanismo de troca.

<configuration>
  <system.serviceModel>
    <bindings>
      <basicHttpContextBinding>

Syntax

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

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 é `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 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`. Um recurso da Internet será local se tiver um endereço local. Um endereço local é aquele que está no mesmo computador, na LAN local ou na intranet e é identificado, sintaticamente, pela falta de um ponto (.) como nos URIs `http://webserver/` e `http://localhost/`. A definição desse atributo determina se os pontos de extremidade configurados com a 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 do localhost) se quiser que os clientes passem por um proxy ao se comunicarem com serviços no mesmo computador quando esse atributo estiver definido como `true`. Quando esse atributo for `false`, todas as solicitações da Internet serão feitas por meio do servidor proxy.
`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 valor 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. 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 saem do canal. Se não houver memória suficiente no pool de buffers para processar a carga da mensagem, o Gerenciador de Buffers precisará alocar memória adicional do heap CLR, o que aumenta a sobrecarga da coleta de lixo. A alocação extensiva do heap de lixo CLR é uma indicação de que o tamanho do pool de buffers é muito pequeno e que o desempenho pode ser aprimorado 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 destinatário. O destinatário remove a mensagem e cria uma entrada do evento no log de rastreamento. O padrão é de 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: use um codificador do MTOM (Message Transmission Organization Mechanism) 1.0. O padrão é texto. Esse atributo é do tipo WSMessageEncoding.
`messageVersion`	Especifica a versão de 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, 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 contém o endereço do proxy HTTP. Se `useSystemWebProxy` estiver definido como `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:10:00.
`sendTimeout`	Um valor TimeSpan que especifica o intervalo de tempo fornecido 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.
`textEncoding`	Define a codificação de conjunto de caracteres a ser usada para emitir mensagens na associaçã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. Esse atributo é do tipo Encoding.
`transferMode`	Um valor TransferMode válido que especifica se as mensagens são armazenadas em buffer ou transmitidas em fluxo contínuo ou uma solicitação ou uma 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	Descrição
<security>	Define as configurações de segurança da associação. Esse elemento é do tipo BasicHttpSecurityElement.
<readerQuotas>	Define as restrições sobre a complexidade das mensagens SOAP que podem ser processadas pelos pontos de extremidade configurados com essa associação. Esse elemento é do tipo XmlDictionaryReaderQuotasElement.

Elementos pai

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

Comentários

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

Compartilhar via