Partager via


<webServices>, élément

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.

Contrôle les paramètres de services Web déployés à l'aide d'ASP.NET et des clients de services Web exécutés sur le .NET Framework.

Hiérarchie de schéma

<configuration>
  <system.web>
    <webServices>, élément

Syntaxe

<webServices> 
   <protocols> 
      <add name="protocol name"/>
      <remove name="protocol name"/>
      <clear/>
   </protocols>
   <serviceDescriptionFormatExtensionTypes> 
      <add type="type"/>
      <remove type="type"/>
      <clear/>
   </serviceDescriptionFormatExtensionTypes>
   <soapExtensionTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionTypes>
   <soapExtensionReflectorTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionReflectorTypes>
   <soapExtensionImporterTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionImporterTypes>
   <wsdlHelpGenerator href="help generator file"/>
   <diagnostics suppressReturningExceptions="true|false" />
</webServices>

Attributs et éléments

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

Attributs

Aucun.

Éléments enfants

Élément enfant Description

diagnostics

Spécifie s'il faut retourner des exceptions au client à des fins de débogage.

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.

serviceDescriptionFormatExtensionTypes

Spécifie l'extension de format de description de service à exécuter dans la portée du fichier de configuration.

soapExtensionTypes

Spécifie les extensions SOAP utilisées pour examiner ou modifier le message SOAP au cours du traitement sur le client ou service Web. Les extensions SOAP augmentent les fonctionnalités des services Web.

soapExtensionReflectorTypes

Spécifie des classes de réflecteur d'extensions SOAP qui étendent le processus de génération de description de service (document WSDL). À utiliser avec les extensions de format de description de service.

soapExtensionImporterTypes

Spécifie des classes d'importateur d'extensions SOAP qui étendent le processus de génération de proxy client. À utiliser avec les extensions de format de description de service.

wsdlHelpGenerator

Spécifie la page d'aide (fichier .aspx) d'un service Web qui s'affiche dans un navigateur lorsque celui-ci accède directement à une page ASMX des services Web.

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

Exemple

L'exemple suivant spécifie les paramètres de configuration du service Web XML.

<configuration>
   <system.web>
      <webServices>
         <diagnostics suppressReturningExceptions="false"/>
         <protocols>
            <add name="HttpGet"/>
            <add name="HttpPost"/>
            <add name="Documentation"/>
         </protocols>
         <serviceDescriptionFormatExtensionTypes>
         </serviceDescriptionFormatExtensionTypes>
         <soapExtensionTypes>
         </soapExtensionTypes>
         <soapExtensionReflectorTypes>
         </soapExtensionReflectorTypes>
         <soapExtensionImporterTypes>
         </soapExtensionImporterTypes>
         <wsdlHelpGenerator href="DefaultSdlHelpGenerator.aspx"/>
      </webServices>
   </system.web>
</configuration>

Voir aussi

Référence

Schéma des paramètres des services Web

Autres ressources

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