<ws2007HttpBinding>

Définit une liaison interopérable qui prend en charge les versions correctes des Securityéléments de liaison et ReliableSession les TransactionFlowéléments de liaison.

<Configuration>
   <system.serviceModel>
     <Liaisons>
       <ws2007HttpBinding>

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributes

Caractéristique	Descriptif
`allowCookies`	Valeur qui indique si le client accepte les cookies et les propage sur les demandes futures. La valeur par défaut est `false`. Vous pouvez utiliser cette propriété lorsque vous interagissez avec ASP.NET services Web (ASMX) qui utilisent des cookies. Cela garantit que les cookies retournés par le serveur sont automatiquement copiés dans toutes les futures demandes clientes pour ce service.
`bypassProxyOnLocal`	Valeur qui indique s’il faut contourner le serveur proxy pour les adresses locales. La valeur par défaut est `false`.
`closeTimeout`	Valeur TimeSpan qui spécifie l’intervalle de temps pour qu’une opération de fermeture se termine. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
`hostNameComparisonMode`	Spécifie le mode de comparaison de noms d’hôte HTTP utilisé pour analyser les URI (Uniform Resource Identifiers). Cet attribut est de type HostNameComparisonMode, qui indique si le nom d’hôte est utilisé pour atteindre le service lors de la correspondance sur l’URI. La valeur par défaut est StrongWildcard, qui ignore le nom d’hôte dans la correspondance.
`maxBufferPoolSize`	Taille maximale du pool de mémoires tampons pour cette liaison. La valeur par défaut est 524 288 octets (512 × 1 024). De nombreuses parties de Windows Communication Foundation (WCF) utilisent des mémoires tampons. La création et la destruction de mémoires tampons chaque fois qu’elles sont utilisées est coûteuse, car il s’agit d’un garbage collection pour les mémoires tampons. Avec les pools de mémoires tampons, vous pouvez prendre une mémoire tampon à partir du pool, l’utiliser et la retourner au pool lorsque vous avez terminé. Cela évite la surcharge lors de la création et de la destruction de mémoires tampons.
`maxReceivedMessageSize`	Taille maximale des messages, en octets, y compris les en-têtes, qu’un canal configuré avec cette liaison peut recevoir. L’expéditeur d’un message dépassant cette limite reçoit une erreur SOAP. Le destinataire supprime le message et crée une entrée de l’événement dans le journal des traces. La valeur par défaut est 65536.
`messageEncoding`	Définit l’encodeur utilisé pour encoder le message. Les valeurs valides sont les suivantes : - `Text`: utilisez un encodeur de sms. - `Mtom`: Utilisez un encodeur MTOM (Message Transmission Organization Mechanism) 1.0 (MTOM). La valeur par défaut est `Text`. Cet attribut est de type WSMessageEncoding.
`name`	Nom de configuration de la liaison. Cette valeur doit être unique, car elle est utilisée comme identification pour la liaison. À compter de .NET Framework 4, les liaisons et les comportements ne sont pas nécessaires pour avoir un nom. Pour plus d’informations sur la configuration par défaut et les liaisons sans nom et les comportements, consultez Configuration simplifiée et Configuration simplifiée pour les services WCF.
`openTimeout`	Valeur TimeSpan qui spécifie l’intervalle de temps fourni pour qu’une opération ouverte se termine. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
`proxyAddress`	URI qui spécifie l’adresse du proxy HTTP. Si `useSystemWebProxy` c’est `true`le cas, ce paramètre doit être `null`. La valeur par défaut est `null`.
`receiveTimeout`	Valeur TimeSpan qui spécifie l’intervalle de temps fourni pour qu’une opération de réception se termine. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
`sendTimeout`	Valeur TimeSpan qui spécifie l’intervalle de temps fourni pour qu’une opération d’envoi se termine. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
`textEncoding`	Spécifie l’encodage du jeu de caractères à utiliser pour émettre des messages sur la liaison. Les valeurs valides sont les suivantes : - `UnicodeFffeTextEncoding`: encodage Big Endian Unicode. - `Utf16TextEncoding`: encodage 16 bits. - `Utf8TextEncoding`: encodage 8 bits. La valeur par défaut est `Utf8TextEncoding`. Cet attribut est de type Encoding.
`transactionFlow`	Valeur qui spécifie si la liaison prend en charge le flux WS-Transactions. La valeur par défaut est `false`.
`useDefaultWebProxy`	Valeur qui spécifie si le proxy HTTP configuré automatiquement par le système est utilisé. La valeur par défaut est `true`.

Éléments enfants

Élément	Descriptif
<sécurité>	Définit les paramètres de sécurité de la liaison. Cet élément est de type WSHttpSecurityElement.
<readerQuotas>	Définit les contraintes sur la complexité des messages SOAP que les points de terminaison configurés avec cette liaison peuvent traiter. Cet élément est de type XmlDictionaryReaderQuotasElement.
<reliableSession>	Spécifie si les sessions fiables sont établies entre les points de terminaison de canal.

Éléments parents

Élément	Descriptif
<Liaisons>	Cet élément contient une collection de liaisons standard et personnalisées.

Remarques

L’ajout WS2007HttpBinding d’une liaison fournie par le système similaire mais WSHttpBinding utilise l’Organisation pour l’avancement des versions standard oasis (Structured Information Standards) des protocoles ReliableSession, Security et TransactionFlow. Aucune modification du modèle objet ou des paramètres par défaut n’est requise lors de l’utilisation de cette liaison.

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>

Voir aussi

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-12-19