Schéma des paramètres des services Web

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.

Le schéma des paramètres des services Web définit les éléments du fichier de configuration qui contrôlent le comportement des services Web ASP.NET et de leurs clients. L'élément parent est <webServices>.

Par défaut, l'élément <webServices> et ses descendants sont appliqués à tout service Web ou classe proxy auquel ou à laquelle la configuration s'applique. La configuration est appliquée en fonction du type d'application, comme suit :

• Application Web ASP.NET (service ou client) : consultez Hiérarchie du fichier de configuration ASP.NET et héritage sur les règles standard de l'héritage, la portée et la priorité de la configuration dans une application Web ASP.NET. L'élément <webServices> se trouve généralement dans un fichier Web.config.

• Application .NET Framework autonome (client uniquement) : consultez la section Fichiers de configuration des applications. L'élément <webServices> se trouve généralement dans le fichier de configuration de l'application.

L'élément <webServices> et ses descendants sont appliqués aux types de classes suivants :

• Classe de service Web dérivée de WebService.

• Classe proxy cliente indirectement dérivée de WebClientProtocol.

Un élément <webServices> peut être appliqué à la fois à un service Web et à un client, où une application Web contient les deux entités.

<configuration>
   <system.web>
      <webServices>
         <protocols>
            <add>
            <remove>
            <clear>
         <serviceDescriptionFormatExtensionTypes>
            <add>
            <remove>
            <clear>
         <soapExtensionTypes>
            <add>
            <remove>
            <clear>
         <soapExtensionImporterTypes>
            <add>
            <remove>
            <clear>
         <soapExtensionReflectorTypes>
            <add>
            <remove>
            <clear>
         <wsdlHelpGenerator>

Élément	Description
<add> pour <protocols>	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.
<add> pour <serviceDescriptionFormatExtensionTypes>	Ajoute une classe d'extension de format de description de service (SDFE, Service Description Format Extension) spécifiée qui définit comment étendre les descriptions de service (documents WSDL) générées pour les services Web.
<add> pour <soapExtensionTypes>	Ajoute une classe d'extensions SOAP spécifiée qui fournit le traitement étendu des messages SOAP sur le client ou le service Web.
<add> pour <soapExtensionImporterTypes>	Ajoute une classe d'importateur d'extensions SOAP spécifiée qui étend le processus de génération du proxy client pour une utilisation avec une extension de format de description de service (SDFE, Service Description Format Extension).
<add> pour <soapExtensionReflectorTypes>	Ajoute une classe de réflecteur d'extensions SOAP spécifiée qui étend le processus de génération de description du service (document WSDL) pour une utilisation avec une extension de format de description de service (SDFE, Service Description Format Extension).
<clear>	Supprime toutes les références à des éléments propres à la balise parente.
<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.
<remove> pour <protocols>	Supprime un protocole spécifié pour gérer les données des demandes et des réponses de la portée du fichier de configuration.
<remove> pour <serviceDescriptionFormatExtensionTypes>	Supprime une classe d'extension de format de description de service spécifiée de la portée du fichier de configuration.
<remove> pour <soapExtensionTypes>	Supprime une classe d'extensions SOAP spécifiée de la portée du fichier de configuration.
<remove> pour <soapExtensionImporterTypes>	Supprime une classe d'importateur d'extensions SOAP spécifiée de la portée du fichier de configuration.
<remove> pour <soapExtensionReflectorTypes>	Supprime une classe de réflecteur d'extensions SOAP spécifiée de la portée du fichier de configuration.
<serviceDescriptionFormatExtensionTypes>	Spécifie les classes d'extensions de format de description de service (SDFE, Service Description Format Extension) utilisées pour étendre les documents WSDL (Web Services Description Language) générés pour les services Web. Les classes SDFE permettent de décrire les extensions SOAP.
<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.
<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.
<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.
<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.
<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.

Voir aussi

Autres ressources

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