<ws2007HttpBinding>

Artigo
05/10/2023

Define uma associação interoperável que dá suporte às versões corretas dos elementos de associação Security, ReliableSession e TransactionFlow.

<configuração>
  <system.serviceModel>
    <associações>
      <ws2007HttpBinding>

Syntax

<ws2007HttpBinding>
  <binding allowCookies="Boolean"
           bypassProxyOnLocal="Boolean"
           closeTimeout="TimeSpan"
           hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
           maxBufferPoolSize="integer"
           maxReceivedMessageSize="Integer"
           messageEncoding="Text/Mtom"
           name="string"
           openTimeout="TimeSpan"
           proxyAddress="URI"
           receiveTimeout="TimeSpan"
           sendTimeout="TimeSpan"
           textEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
           transactionFlow="Boolean"
           useDefaultWebProxy="Boolean">
    <reliableSession ordered="Boolean"
                     inactivityTimeout="TimeSpan"
                     enabled="Boolean" />
    <security mode="Message/None/Transport/TransportWithCredential">
      <transport clientCredentialType="Basic/Certificate/Digest/None/Ntlm/Windows"
                 proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                 realm="string" />
        <message clientCredentialType ="Certificate/IssuedToken/None/UserName/Windows"
                 negotiateServiceCredential="Boolean"
                 algorithmSuite="Basic128/Basic192/Basic256/Basic128Rsa15/Basic256Rsa15/TripleDes/TripleDesRsa15/Basic128Sha256/Basic192Sha256/TripleDesSha256/Basic128Sha256Rsa15/Basic192Sha256Rsa15/Basic256Sha256Rsa15/TripleDesSha256Rsa15"
                 establishSecurityContext="Boolean" />
    </security>
    <readerQuotas maxArrayLength="Integer"
                  maxBytesPerRead="Integer"
                  maxDepth="Integer"
                  maxNameTableCharCount="Integer"
                  maxStringContentLength="Integer" />
  </binding>
</ws2007HttpBinding>

Atributos e elementos

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

Atributos

Atributo	Descrição
`allowCookies`	Um valor 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 ASP.NET (ASMX) que usam cookies. Isso garante que os cookies retornados pelo servidor sejam automaticamente copiados para todas as solicitações futuras do cliente para esse serviço.
`bypassProxyOnLocal`	Um valor que indica quando ignorar o servidor proxy 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 de host HTTP usado para analisar URIs (Uniform Resource Identifiers). Esse atributo é do tipo HostNameComparisonMode, o qual indica se o nome do host é usado para alcançar 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`	O tamanho máximo do pool de buffers dessa associação. O padrão é 524.288 bytes (512 × 1.024). Muitas partes do WCF (Windows Communication Foundation) usam buffers. Custa caro criar e destruir buffers cada vez que eles são usados, assim como a coleta de lixo para buffers. Com pools de buffers, é possível pegar um buffer do pool, usá-lo e devolvê-lo ao pool quando você terminar. Isso evita a sobrecarga na criação e destruição de buffers.
`maxReceivedMessageSize`	O tamanho máximo da mensagem, em bytes, incluindo cabeçalhos, que um canal configurado com essa associação pode receber. O remetente de uma mensagem que exceder esse limite recebe uma falha SOAP. O receptor remove a mensagem e cria uma entrada do evento no log de rastreamento. O padrão é 65536.
`messageEncoding`	Define o codificador usado para codificar a mensagem. Os valores válidos incluem os seguintes: - `Text`: use um codificador de mensagens de texto. - `Mtom`: use um codificador MTOM (Mecanismo de Organização de Transmissão de Mensagens 1.0). O padrão é `Text`. Esse atributo é do tipo WSMessageEncoding.
`name`	O nome da 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.
`textEncoding`	Especifica a codificação do conjunto de caracteres a ser usada para emitir mensagens na associação. Os valores válidos incluem os seguintes: - `UnicodeFffeTextEncoding`: codificação Unicode Big Endian. - `Utf16TextEncoding`: codificação de 16 bits. - `Utf8TextEncoding`: codificação de 8 bits. O padrão é `Utf8TextEncoding`. Esse atributo é do tipo Encoding.
`transactionFlow`	Um valor que especifica se a associação dá suporte ao fluxo de WS-Transactions. O padrão é `false`.
`useDefaultWebProxy`	Um valor que especifica se o proxy HTTP configurado automaticamente do sistema é usado. O padrão é `true`.

Elementos filho

Elemento	Descrição
<security>	Define as configurações de segurança da associação. Esse elemento é do tipo WSHttpSecurityElement.
<readerQuotas>	Define as restrições sobre a complexidade das mensagens SOAP que os pontos de extremidade configuraram com essa associação. Esse elemento é do tipo XmlDictionaryReaderQuotasElement.
<reliableSession>	Especifica se sessões as confiáveis são estabelecidas entre pontos de extremidade de canal.

Elementos pai

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

Comentários

O WS2007HttpBinding adiciona uma associação fornecida pelo sistema semelhante a WSHttpBinding, mas usa as versões padrão da Organização para o Avanço dos Padrões de Informações Estruturadas (OASIS) dos protocolos ReliableSession, Security e TransactionFlow. Nenhuma alteração no modelo de objeto ou nas configurações padrão é necessária ao usar essa associação.

Exemplo

<configuration>
  <system.ServiceModel>
    <bindings>
      <ws2007HttpBinding>
        <binding closeTimeout="00:00:10"
                 openTimeout="00:00:20"
                 receiveTimeout="00:00:30"
                 sendTimeout="00:00:40"
                 bypassProxyOnLocal="false"
                 transactionFlow="false"
                 hostNameComparisonMode="WeakWildcard"
                 maxReceivedMessageSize="1000"
                 messageEncoding="Mtom"
                 proxyAddress="http://www.contoso.com"
                 textEncoding="utf-16"
                 useDefaultWebProxy="false">
          <reliableSession ordered="false"
                           inactivityTimeout="00:02:00"
                           enabled="true" />
          <security mode="Transport">
            <transport clientCredentialType="Digest"
                       proxyCredentialType="None"
                       realm="someRealm" />
            <message clientCredentialType="Windows"
                     negotiateServiceCredential="false"
                     algorithmSuite="Aes128"
                     defaultProtectionLevel="None" />
          </security>
        </binding>
      </ws2007HttpBinding>
    </bindings>
  </system.ServiceModel>
</configuration>

Compartilhar via