<ws2007HttpBinding>

Artigo
06/21/2023

Define um enlace interoperável que fornece suporte para as versões corretas dos Securityelementos , ReliableSessione TransactionFlow enlace.

<configuração>
  <system.serviceModel>
    <enlaces>
      <ws2007HttpBinding>

Sintaxe

<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 secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo	Descrição
`allowCookies`	Um valor que indica se o cliente aceita cookies e os propaga em pedidos futuros. A predefinição é `false`. Pode utilizar esta propriedade quando interage com ASP.NET serviços Web (ASMX) que utilizam cookies. Isto garante que os cookies devolvidos pelo servidor são automaticamente copiados para todos os futuros pedidos de cliente para esse serviço.
`bypassProxyOnLocal`	Um valor que indica se deve ignorar o servidor proxy para endereços locais. A predefinição é `false`.
`closeTimeout`	Um TimeSpan valor que especifica o intervalo de tempo para uma operação de fecho ser concluída. Este valor deve ser maior ou igual a Zero. A predefinição é 00:01:00.
`hostNameComparisonMode`	Especifica o modo de comparação de nome de anfitrião HTTP utilizado para analisar Os Identificadores de Recursos Uniformes (URIs). Este atributo é do tipo HostNameComparisonMode, que indica se o nome do anfitrião é utilizado para aceder ao serviço quando corresponde ao URI. O valor predefinido é StrongWildcard, que ignora o nome do anfitrião na correspondência.
`maxBufferPoolSize`	O tamanho máximo do conjunto de memória intermédia para este enlace. A predefinição é 524.288 bytes (512 × 1.024). Muitas partes do Windows Communication Foundation (WCF) utilizam memórias intermédias. A criação e destruição de memórias intermédias sempre que são utilizadas é dispendiosa, tal como a libertação de memória intermédia. Com os conjuntos de memória intermédia, pode tirar uma memória intermédia do conjunto, utilizá-la e devolvê-la ao conjunto quando terminar. Isto evita a sobrecarga ao criar e destruir memórias intermédias.
`maxReceivedMessageSize`	O tamanho máximo da mensagem, em bytes, incluindo cabeçalhos, que um canal configurado com este enlace pode receber. O remetente de uma mensagem que excede este limite recebe uma falha SOAP. O recetor remove a mensagem e cria uma entrada do evento no registo de rastreio. A predefinição é 65536.
`messageEncoding`	Define o codificador utilizado para codificar a mensagem. Os valores válidos incluem o seguinte: - `Text`: utilize um codificador de mensagens de texto. - `Mtom`: utilize um codificador MTOM (Message Transmission Organization Mechanism 1.0). A predefinição é `Text`. Este atributo é do tipo WSMessageEncoding.
`name`	O nome de configuração do enlace. Este valor deve ser exclusivo porque é utilizado como uma identificação para o enlace. A partir do .NET Framework 4, não são necessários enlaces e comportamentos para ter um nome. Para obter mais informações sobre a configuração predefinida e os enlaces e comportamentos sem nome, veja Configuração Simplificada e Configuração Simplificada para os Serviços WCF.
`openTimeout`	Um TimeSpan valor que especifica o intervalo de tempo fornecido para a conclusão de uma operação aberta. Este valor deve ser maior ou igual a Zero. A predefinição é 00:01:00.
`proxyAddress`	Um URI que especifica o endereço do proxy HTTP. Se `useSystemWebProxy` for `true`, esta definição tem de 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. A predefinição é 00:01:00.
`sendTimeout`	Um TimeSpan valor que especifica o intervalo de tempo fornecido para a conclusão de uma operação de envio. Este valor deve ser maior ou igual a Zero. A predefinição é 00:01:00.
`textEncoding`	Especifica a codificação do conjunto de carateres a utilizar para emitir mensagens no enlace. Os valores válidos incluem o seguinte: - `UnicodeFffeTextEncoding`: Codificação Unicode Big Endian. - `Utf16TextEncoding`: codificação de 16 bits. - `Utf8TextEncoding`: codificação de 8 bits. A predefinição é `Utf8TextEncoding`. Este atributo é do tipo Encoding.
`transactionFlow`	Um valor que especifica se o enlace suporta WS-Transactions fluído. A predefinição é `false`.
`useDefaultWebProxy`	Um valor que especifica se o proxy HTTP configurado automaticamente do sistema é utilizado. A predefinição é `true`.

Elementos Subordinados

Elemento	Descrição
<segurança>	Define as definições de segurança do enlace. Este elemento é do tipo WSHttpSecurityElement.
<readerQuotas>	Define as restrições sobre a complexidade das mensagens SOAP que os pontos finais configurados com este enlace podem processar. Este elemento é do tipo XmlDictionaryReaderQuotasElement.
<reliableSession>	Especifica se são estabelecidas sessões fiáveis entre pontos finais de canal.

Elementos Principais

Elemento	Descrição
<enlaces>	Este elemento contém uma coleção de enlaces padrão e personalizados.

Observações

O WS2007HttpBinding adiciona um enlace fornecido pelo sistema semelhante ao WSHttpBinding , mas utiliza as versões padrão da Organização para o Avanço das Normas de Informação Estruturada (OASIS) dos protocolos ReliableSession, Security e TransactionFlow. Não são necessárias alterações ao modelo de objeto ou às predefinições ao utilizar este enlace.

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>

Partilhar via