Schema delle impostazioni dei servizi Web

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

Lo schema delle impostazioni dei servizi Web definisce gli elementi del file di configurazione che controllano il comportamento dei servizi Web ASP.NET e dei relativi client. L'elemento padre è <webServices>.

Per impostazione predefinita, l'elemento <webServices> e i relativi discendenti vengono applicati a qualsiasi servizio Web o classe proxy a cui si applica la configurazione. La configurazione viene applicata in base al tipo di applicazione nel modo seguente:

• Applicazione Web ASP.NET (servizio o client): fare riferimento a Gerarchia ed ereditarietà dei file di configurazione di ASP.NET in cui sono illustrate le regole standard relative all'eredità di configurazione, all'ambito e alla precedenza all'interno di un'applicazione Web ASP.NET. L'elemento <webServices> viene generalmente inserito in un file Web.config.

• Applicazione .NET Framework autonoma (solo client): fare riferimento a File di configurazione dell'applicazione. L'elemento <webServices> viene generalmente inserito nel file di configurazione dell'applicazione.

L'elemento <webServices> e i relativi discendenti vengono applicati ai tipi di classi seguenti:

• Una classe del servizio Web derivata da WebService.

• Classe proxy client derivata indirettamente da WebClientProtocol.

Un elemento <webServices> può essere applicato sia a un servizio Web che a un client in cui un'applicazione Web contiene entrambe le entità.

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

Elemento	Descrizione
<add> per <protocols>	Aggiunge un protocollo specificato che può essere utilizzato da un servizio Web ASP.NET per ricevere dati di richiesta inviati da un client e restituire dati di risposta.
<add> per <serviceDescriptionFormatExtensionTypes>	Aggiunge una classe di estensioni di formato di descrizione servizio (SDFE, Service Description Format Extension) specificata che definisce la modalità di estensione delle descrizioni dei servizi (documenti WSDL) generate per i servizi Web.
<add> per <soapExtensionTypes>	Aggiunge una classe di estensioni SOAP specificata che fornisce un'elaborazione estesa dei messaggi SOAP sul servizio o client Web.
<add> per <soapExtensionImporterTypes>	Aggiunge una classe dell'utilità di importazione delle estensioni SOAP specificata, che estende il processo di generazione del proxy client da utilizzare con un'estensione di formato di descrizione servizio (SDFE, Service Description Format Extension).
<add> per <soapExtensionReflectorTypes>	Aggiunge una classe del riflettore di estensioni SOAP specificata, che estende il processo di generazione della descrizione del servizio (documento WSDL) da utilizzare con un'estensione del formato di descrizione servizio (SDFE, Service Description Format Extension).
<clear>	Consente di rimuovere tutti i riferimenti agli elementi appropriati al tag padre.
<protocols>	Specifica i protocolli che un servizio Web ASP.NET può utilizzare per ricevere i dati della richiesta inviati da un client e restituire i dati di risposta. Un protocollo può essere utilizzato per associare dati di richiesta a un metodo e ai relativi parametri e per associare dati di risposta al metodo e al relativo valore restituito.
<remove> per <protocols>	Rimuove un protocollo specificato per la gestione di dati di richiesta e di risposta dall'ambito del file di configurazione.
<remove> per <serviceDescriptionFormatExtensionTypes>	Rimuove una classe di estensioni di formato di descrizione servizio (SDFE, Service Description Format Extension) specificata dall'ambito del file di configurazione.
<remove> per <soapExtensionTypes>	Rimuove una classe di estensioni SOAP specificata dall'ambito del file di configurazione.
<remove> per <soapExtensionImporterTypes>	Rimuove una classe dell'utilità di importazione delle estensioni SOAP specificata dall'ambito del file di configurazione.
<remove> per <soapExtensionReflectorTypes>	Rimuove una classe del riflettore delle estensioni SOAP specificata dall'ambito del file di configurazione.
<serviceDescriptionFormatExtensionTypes>	Specifica le classi di estensioni di formato di descrizione servizio (SDFE, Service Description Format Extension) utilizzate per estendere i documenti WSDL generati per i servizi Web. Le classi SDFE offrono un metodo per la descrizione delle estensioni SOAP.
<soapExtensionImporterTypes>	Specifica le classi dell'utilità di importazione delle estensioni SOAP che estendono il processo di generazione proxy del client. Da utilizzare con le estensioni di formato di descrizione servizio (SDFE).
<soapExtensionReflectorTypes>	Specifica le classi del riflettore di estensioni SOAP che estendono il processo di generazione della descrizione del servizio (documento WSDL). Da utilizzare con le estensioni di formato di descrizione servizio (SDFE).
<soapExtensionTypes>	Specifica le estensioni SOAP utilizzate per ispezionare o modificare il messaggio SOAP durante l'elaborazione del servizio o client Web. Le estensioni SOAP estendono la funzionalità dei servizi Web.
<webServices>	Verifica le impostazioni dei servizi Web distribuite utilizzando ASP.NET e dei client dei servizi Web in esecuzione su .NET Framework.
<wsdlHelpGenerator>	Specifica la pagina della Guida del servizio Web (un file aspx) visualizzata in un browser quando il browser passa direttamente a una pagina dei servizi Web ASMX.

Vedere anche

Altre risorse

ASP.NET Settings Schema
Servizi Web XML creati mediante ASP.NET e tramite client di servizi Web XML