Condividi tramite

Procedura: disabilitare la pagina della Guida del servizio per un servizio Web

  • Articolo

Questo argomento è specifico di una tecnologia legacy. Servizi Web XML e client di servizi Web XML devono essere creati attualmente tramite Windows Communication Foundation.

Spostarsi con un browser nell’URL del servizio Web senza avere specificato parametri produce una pagina della guida HTML, se la pagina è abilitata (come da impostazione predefinita nel file machine.config del server). La pagina della Guida del servizio e la configurazione sono descritte dettagliatamente in Opzioni di configurazione per i servizi Web XML creati tramite ASP.NET.

Per disabilitare la pagina della Guida del servizio di una singola applicazione Web

  1. Con l’editor preferito, aprire il file Web.config nella directory radice dell’applicazione Web. (Se non esiste un file Web.config, crearne uno.)

  2. Modificare la sezione webServices di Web.config per rimuovere in modo esplicito il protocollo Documentazione.

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

  3. Salvare Web.config.

    Questa modifica della configurazione avrà effetto alla successiva richiesta di un servizio Web presente nell'applicazione Web.

    2tyf2t8t.note(it-it,VS.100).gifNota:
    La rimozione del protocollo Documentation disabilita inoltre la generazione del file WSDL per tutti i servizi Web all'interno dell'applicazione Web. In questo modo, viene impedito ai client di generare una classe proxy a meno che non venga creato e reso disponibile un file WSDL personalizzato. Per lasciare attiva la generazione di file WSDL per i servizi Web all'interno di un'applicazione Web, senza tuttavia fornire informazioni leggibili relative ai servizi Web, è possibile aggiungere un elemento <wsdlHelpGenerator> al file Web.config dell'applicazione Web e impostare l'attributo href su una pagina HTML vuota precedentemente creata. L'esempio di codice riportato di seguito è tratto da un file Web.config in cui la pagina della Guida del servizio viene impostata su un file MyBlank.htm nella sottocartella docs all'interno della cartella contenente il file Web.config. 

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

Vedere anche

Attività

Procedura: disabilitare il supporto per il protocollo per i servizi Web
Procedura: abilitare l'individuazione per i servizi Web XML

Concetti

Opzioni di configurazione per i servizi Web XML creati tramite ASP.NET
Distribuzione di servizi Web XML

Altre risorse

Creare servizi Web XML mediante ASP.NET