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

Article
08/21/2007

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>, élément
  system.web, élément (Schéma des paramètres ASP.NET)
    <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.

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(e).

É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

Paramètres de configuration ASP.NET
Services Web XML créés à l'aide de clients de service Web XML et d'ASP.NET
ASP.NET Configuration

Partager via