<webHttpBinding>

Article
02/27/2011

Définit un élément de liaison qui permet de configurer des points de terminaison pour les services Web Windows Communication Foundation (WCF) qui répondent à des requêtes HTTP à la place des messages SOAP.

Hiérarchie de schéma

<system.serviceModel>
<bindings>
<wsHttpBinding>

Syntaxe

<webHttpBinding>
    <binding 
        allowCookies="Boolean"
        bypassProxyOnLocal="Boolean"
        closeTimeout="TimeSpan"
        hostNameComparisonMode="StrongWildCard/Exact/WeakWildcard"
        maxBufferPoolSize="integer"
        maxBufferSize="integer"
        maxReceivedMessageSize="Integer"
        name="string"
        openTimeout="TimeSpan" 
        proxyAddress="URI"
        receiveTimeout="TimeSpan"
        sendTimeout="TimeSpan"
                transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
        useDefaultWebProxy="Boolean">
                
writeEncoding="UnicodeFffeTextEncoding/Utf16TextEncoding/Utf8TextEncoding"
        <security mode="None/Transport/TransportCredentialOnly">
            <transport clientCredentialType = 
                 "Basic/Certificate/Digest/None/Ntlm/Windows"
                  proxyCredentialType="Basic/Digest/None/Ntlm/Windows"
                  realm="string" />
        </security>
       <readerQuotas             maxArrayLength="Integer"            maxBytesPerRead="Integer"            maxDepth="Integer"             maxNameTableCharCount="Integer"                     maxStringContentLength="Integer" />
    </binding>
</webHttpBinding>

Attributs et éléments

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

Attributs

Attribut	Description
allowCookies	Valeur booléenne qui indique si le client accepte les cookies et les propage dans de futures demandes. La valeur par défaut est false. Vous pouvez utiliser cette propriété lorsque vous interagissez avec les services Web ASMX qui utilisent des cookies. De cette manière, vous avez la certitude que les cookies retournés par le serveur sont automatiquement copiés dans toutes les futures demandes du client pour ce service.
bypassProxyOnLocal	Valeur booléenne qui indique s'il faut ignorer le serveur proxy pour les adresses locales. La valeur par défaut est false.
closeTimeout	TimeSpan qui spécifie l'intervalle de temps prévu pour la réalisation d'une opération de fermeture. 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 du nom d'hôte HTTP utilisé pour analyser des URI. Cet attribut est de type HostnameComparisonMode, ce qui indique si le nom d'hôte est utilisé pour atteindre le service en cas de correspondance sur l'URI. La valeur par défaut est StrongWildcard, qui ignore le nom d'hôte dans la correspondance.
maxBufferPoolSize	Entier qui spécifie la taille maximale du pool de mémoires tampons pour cette liaison. La valeur par défaut est 524 288 octets (512 x 1024). De nombreuses parties de Windows Communication Foundation (WCF) utilisent des mémoires tampons. La création et la destruction des mémoires tampons à chaque utilisation sont chères, tout comme leur nettoyage. Avec les pools de mémoires tampons, vous pouvez prendre une mémoire tampon du pool, l'utiliser et la retourner au pool une fois que vous avez terminé. Ainsi, la surcharge de la création et de la destruction des mémoires tampons est évitée.
maxBufferSize	Entier qui spécifie la quantité de mémoire maximale allouée pour une utilisation par le gestionnaire des tampons de messages qui reçoivent des messages du canal. La valeur par défaut est de 524 288 (0x80000) octets.
maxReceivedMessageSize	Entier positif qui spécifie la taille maximale du message, en octets, y compris les en-têtes, pouvant être reçu sur un canal configuré avec cette liaison. L'expéditeur d'un message qui dépasse cette limite se verra notifier une erreur. Le récepteur abandonne le message et crée une entrée d'événement dans le journal de suivi. La valeur par défaut est 65 536. Remarque : L'augmentation de cette valeur uniquement n'est pas suffisant en mode compatible ASP.NET. Vous devez aussi augmenter la valeur de httpRuntime (consultez httpRuntime Element (ASP.NET Settings Schema)).
name	Chaîne qui contient le nom de configuration de la liaison. Cette valeur doit être unique car elle permet d'identifier la liaison. Depuis .NET Framework 4, les liaisons et les comportements ne sont pas obligés d'avoir un nom. Pour plus d'informations sur la configuration par défaut, ainsi que sur les comportements et les liaisons sans nom, consultez Simplified Configuration et Simplified Configuration for WCF Services.
openTimeout	Valeur TimeSpan qui spécifie l'intervalle de temps prévu pour la réalisation d'une opération d'ouverture. 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 est true, ce paramètre doit avoir la valeur Null. La valeur par défaut est Null.
receiveTimeout	TimeSpan qui spécifie l'intervalle de temps prévu pour la réalisation d'une opération de réception. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
sendTimeout	TimeSpan qui spécifie l'intervalle de temps prévu pour la réalisation d'une opération d'envoi. Cette valeur doit être supérieure ou égale à Zero. La valeur par défaut est 00:01:00.
transferMode.	Valeur TransferMode qui indique si le service configuré avec les liaisons utilise des modes de transfert de messages en continu ou en mémoire tampon (ou les deux). La valeur par défaut est Buffered.
useDefaultWebProxy	Valeur booléenne qui spécifie si le proxy HTTP du système configuré automatiquement est utilisé. La valeur par défaut est true.
writeEncoding	Spécifie l'encodage de caractères utilisé pour le texte du message. Les valeurs valides sont les suivantes : UnicodeFffeTextEncoding : encodage Unicode Big Endian. Utf16TextEncoding : encodage 16 bits. Utf8TextEncoding : encodage 8 bits. La valeur par défaut est Utf8TextEncoding.

Éléments enfants

Élément	Description
<readerQuotas>	Définit les contraintes de la complexité des messages POX qui peuvent être traités par les points de terminaison configurés avec cette liaison. Cet élément est de type XmlDictionaryReaderQuotasElement.
<security> de <webHttpBinding>	Définit les paramètres de sécurité de la liaison. Cet élément est de type WSHttpSecurityElement.

Éléments parents

Élément	Description
<bindings>	Cet élément conserve une collection de liaisons standard et personnalisées.

Notes

Le modèle de programmation du Web WCF permet aux développeurs d'exposer des services Web WCF à travers les requêtes HTTP qui utilisent la messagerie de style « XML de base » (POX) au lieu de la messagerie basée sur SOAP. Pour que les clients puissent communiquer avec un service à l'aide de requêtes HTTP, un point de terminaison du service doit être configuré avec le <wsHttpBinding> auquel <WebHttpBehavior> est joint.

Le support de WCF pour la syndication et l'intégration ASP.AJAX est construit au sommet du modèle de programmation Web. Pour plus d'informations sur le modèle, consultez Web Programming Model.

Voir aussi

Référence

WebHttpBinding
WebHttpBindingElement

Concepts

Autres ressources

Web Programming Model
Windows Communication Foundation Bindings
Configuring System-Provided Bindings
Using Bindings to Configure Services and Clients

Partager via