Cette documentation est archivée et n’est pas conservée.

Comment : désactiver la page d'aide d'un service 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 .

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

Afficher: