Partager via

Comment : désactiver la page d'aide d'un service Web

  • Article

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.

L'ouverture dans un navigateur Web de l'URL du service Web sans paramètre produit une page d'aide HTML, si la page est activée (ce qui est le cas par défaut dans le fichier machine.config d'un serveur). La page d'aide du service et sa configuration sont discutées plus en détail dans Options de configuration pour les services Web XML créés à l'aide d'ASP.NET.

Pour désactiver la page d'aide de service pour une application Web donnée

  1. Ouvrez le fichier Web.config dans le répertoire racine de l'application Web dans votre éditeur de texte. (Si aucun fichier Web.config n'existe, créez-en un.)

  2. Modifiez la section webServices de Web.config pour supprimer explicitement le protocole Documentation.

    <webServices>
     <protocols>
       <remove name="Documentation" />
     </protocols>
</webServices>

  3. Enregistrez Web.config.

    Cette modification de configuration entrera en vigueur à la prochaine demande vers un service Web hébergé par l'application Web.

    2tyf2t8t.note(fr-fr,VS.100).gifRemarque :
    La suppression du protocole Documentation désactive également la génération de fichier WSDL pour tous les services Web dans l'application Web. Cela empêche les clients de générer une classe proxy à moins qu'un fichier WSDL personnalisé soit créé et fourni pour eux. Pour laisser la génération de fichier WSDL activée pour les services Web dans une application Web, mais ne pas fournir d'informations lisibles par des humains concernant les services Web, vous pouvez ajouter un élément <wsdlHelpGenerator> au fichier Web.config pour l'application Web et définir l'attribut href sur une page HTML vierge que vous avez créée. L'exemple de code suivant est un extrait d'un fichier Web.config qui affecte à la page d'aide de service un fichier MyBlank.htm dans le dossier docs sous le dossier contenant le fichier Web.config. 

    <webServices>
   <wsdlHelpGenerator href="docs/MyBlank.htm"/>
</webServices>

Voir aussi

Tâches

Comment : désactiver la prise en charge de protocoles pour les services Web
Comment : activer la découverte pour les services Web XML

Concepts

Options de configuration pour les services Web XML créés à l'aide d'ASP.NET
Déploiement des services Web XML

Autres ressources

Services Web XML utilisant ASP.NET