<add>, élément de <protocols>

Article
02/27/2011

Cette rubrique est spécifique à une technologie existante. Les services Web XML et les clients du service Web XML doivent à présent être créés à l'aide de Windows Communication Foundation.

Ajoute un protocole spécifié qu'un service Web ASP.NET peut utiliser pour recevoir les données de la demande envoyées par un client et retourner les données de la réponse. Un protocole peut être utilisé pour associer les données de la demande à une méthode et ses paramètres, et associer les données de la réponse à la méthode et sa valeur de retour.

Hiérarchie de schéma

<configuration>
  <system.web>
    <webServices>, élément
      <protocols>, élément
        <add>, élément de <protocols>

Syntaxe

<add name="protocol name"/>

Attributs et éléments

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

Attributs

Attribut	Description
name	Attribut requis. Nom du protocole à ajouter.

name

Attribut requis.

Nom du protocole à ajouter.

Éléments enfants

Aucun.

Éléments parents

Élément	Description
configuration	Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
system.web	Spécifie l'élément racine de la section de configuration ASP.NET. Contient des éléments de configuration qui configurent les applications Web ASP.NET et contrôlent le comportement des applications.
webServices	Contrôle les paramètres de services Web déployés en utilisant ASP.NET et de clients de services Web qui sont exécutés sur le .NET Framework.
protocols	Spécifie les protocoles qu'un service Web ASP.NET peut utiliser pour recevoir les données de la demande envoyées par un client et retourner les données de la réponse. Un protocole peut être utilisé pour associer les données de la demande à une méthode et ses paramètres, et associer les données de la réponse à la méthode et sa valeur de retour.

Notes

Les quatre protocoles possibles utilisent le protocole HTTP/1.1 (Hypertext Transfer Protocol) comme transport. Littéralement, les valeurs de protocole HttpGet et HttpPost utilisent les méthodes GET et POST de HTTP. La valeur HttpSoap utilise également la méthode POST, mais sans la sémantique HTTP POST classique utilisée par un formulaire HTML.

Exemple

L'exemple suivant active les quatre protocoles pris en charge.

<configuration>
   <system.web>
      <webServices>
         <protocols>
            <add name="HttpSoap"/>
            <add name="HttpPost"/>
            <add name="HttpGet"/>
            <add name="Documentation"/>
         </protocols>
      </webServices>
   </system.web>
</configuration>

Voir aussi

Référence

<webServices>, élément
<protocols>, élément

Autres ressources

ASP.NET Settings Schema
Création de services Web XML à l'aide de clients de service Web XML et ASP.NET

Partager via