Compartilhar via


<ws2007HttpBinding>

Define uma associação interoperável que fornece suporte para as versões corretas dos Securityelementos de associação e ReliableSession de associaçãoTransactionFlow.

<configuration>
  <system.serviceModel>
    <bindings>
      <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 seções a seguir descrevem atributos, elementos filho e elementos pai.

Attributes

Attribute Description
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 ASP.NET SERVIÇOS Web (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 se o servidor proxy deve ser ignorado para endereços locais. O padrão é false.
closeTimeout Um TimeSpan valor que especifica o intervalo de tempo para uma operação de fechamento ser 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 (Uniform Resource Identifiers). 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 O tamanho máximo do pool de buffers para essa associação. O padrão é 524.288 bytes (512 × 1.024). Muitas partes do Windows Communication Foundation (WCF) usam buffers. Criar e destruir buffers sempre que eles são usados é caro, assim como a coleta de lixo para buffers. Com pools de buffer, você pode tirar um buffer do pool, usá-lo e devolvê-lo ao pool quando 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 excede esse limite recebe uma falha SOAP. O receptor descarta 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 o seguinte:

- Text: use 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 é Text.

Esse atributo é do tipo WSMessageEncoding.
name O nome da 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 especifica o endereço do proxy HTTP. Se useSystemWebProxy for true, essa configuração deve 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:01: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 Especifica a codificação do conjunto de caracteres a ser usada para emitir mensagens na associação. 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.

O padrão é Utf8TextEncoding.

Esse atributo é do tipo Encoding.
transactionFlow Um valor que especifica se a associação dá suporte a WS-Transactions em fluxo. 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 Description
<segurança> Define as configurações de segurança para a associação. Esse elemento é do tipo WSHttpSecurityElement.
<Readerquotas> Define as restrições sobre a complexidade das mensagens SOAP que os pontos de extremidade configurados com essa associação podem processar. Esse elemento é do tipo XmlDictionaryReaderQuotasElement.
<Reliablesession> Especifica se as sessões confiáveis são estabelecidas entre pontos de extremidade de canal.

Elementos pai

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

Observações

Adiciona WS2007HttpBinding uma associação fornecida pelo sistema semelhante, 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 configurações padrão é necessária ao usar essa associação.

Example

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

Consulte também