Partager via

<webHttpBinding>

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

<Configuration>
   <system.serviceModel>
     <Liaisons>
       <webHttpBinding>

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 les attributs, les éléments enfants et les éléments parents

Attributes

Caractéristique Descriptif
allowCookies Valeur booléenne 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 les services Web ASMX qui utilisent des cookies. De cette façon, vous pouvez vous assurer que les cookies retournés par le serveur sont automatiquement copiés vers toutes les futures demandes clientes pour ce service.
bypassProxyOnLocal Valeur booléenne 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 fourni 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. 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 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 * 1024). 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 et le garbage collection pour les mémoires tampons est également coûteux. Avec les pools de mémoires tampons, vous pouvez prendre une mémoire tampon à partir du pool, l’utiliser et la retourner au pool une fois que vous avez terminé. Ainsi, la surcharge dans la création et la destruction de mémoires tampons est évitée.
maxBufferSize Entier qui spécifie la quantité maximale de mémoire allouée pour une utilisation par le gestionnaire des mémoires tampons de messages qui reçoivent des messages du canal. La valeur par défaut est 524 288 octets (0x80000).
maxReceivedMessageSize Entier positif qui spécifie la taille maximale du message, en octets, y compris les en-têtes, qui peuvent être reçus sur un canal configuré avec cette liaison. L’expéditeur d’un message dépassant cette limite reçoit une erreur. 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. Note: L’augmentation de cette valeur seule n’est pas suffisante en mode compatible ASP.NET. Vous devez également augmenter la valeur de httpRuntime (voir httpRuntime, élément (ASP.NET Schema Settings)).
nom Chaîne qui contient le 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 truele 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.
transferMode. Valeur TransferMode qui indique si le service configuré avec la liaison utilise des modes de transfert de messages en continu ou mis 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 configuré automatiquement par le système 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 BigEndian Unicode.

Utf16TextEncoding : encodage 16 bits.

Utf8TextEncoding : encodage 8 bits.

La valeur par défaut est Utf8TextEncoding.

Éléments enfants

Élément Descriptif
<readerQuotas> Définit les contraintes relatives à 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.
<sécurité> Définit les paramètres de sécurité de la liaison. Cet élément est de type WebHttpSecurityElement.

Éléments parents

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

Remarques

Le modèle de programmation web WCF permet aux développeurs d’exposer des services Web WCF via des requêtes HTTP qui utilisent la messagerie de style POX (plain old XML) au lieu de la messagerie BASÉE sur SOAP. Pour que les clients communiquent avec un service à l’aide de requêtes HTTP, un point de terminaison du service doit être configuré avec le <webHttpBinding> associé à <WebHttpBehavior> .

Prise en charge dans WCF pour la syndication et ASP. L’intégration AJAX est basée sur le modèle de programmation web. Pour plus d’informations sur le modèle, consultez le modèle de programmation HTTP web WCF.

Voir aussi

  • Last updated on