Partager via

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

  • Article

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.

<configuration>

  <system.web>

    <webServices>, élément

      <protocols>, élément

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

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

Attribut name

Valeur Description

HttpGet

  • Ajoute le protocole HTTP GET. Les paramètres de méthode sont passés dans la chaîne de requête qui est ajoutée à l'URL de demande HTTP, sous la forme ?name1=value1&name2=value2…. La valeur de retour est placée dans le corps de la réponse HTTP comme un document XML simple (aucun <soap:Envelope>).

HttpPost

Ajoute le protocole HTTP POST. Les paramètres de méthode sont passés dans le corps de la demande HTTP, sous la forme name1=value1&name2=value…. La valeur de retour est placée dans le corps de la réponse HTTP comme un document XML simple (aucun <soap:Envelope>).

HttpSoap

Ajoute le protocole HTTP SOAP. Un message SOAP est envoyé dans le corps de la demande HTTP ; la réponse SOAP est envoyée dans le corps de la réponse HTTP.

Documentation

Ajoute le protocole spécial Documentation. Lorsque ce protocole est activé et que la page .asmx est demandée directement, ASP.NET exécute une page d'assistance pour qu'une page de documentation HTML soit créée et fournie au client demandeur.

É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

Footer image

Copyright ©2007 par Microsoft Corporation. Tous droits réservés.