Elemento <webServices>

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

Verifica le impostazioni dei servizi Web distribuiti utilizzando ASP.NET e dei client del servizio Web in esecuzione su .NET Framework.

Gerarchia dello schema

<configuration>
  <system.web>
    Elemento <webServices>

Sintassi

<webServices> 
   <protocols> 
      <add name="protocol name"/>
      <remove name="protocol name"/>
      <clear/>
   </protocols>
   <serviceDescriptionFormatExtensionTypes> 
      <add type="type"/>
      <remove type="type"/>
      <clear/>
   </serviceDescriptionFormatExtensionTypes>
   <soapExtensionTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionTypes>
   <soapExtensionReflectorTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionReflectorTypes>
   <soapExtensionImporterTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionImporterTypes>
   <wsdlHelpGenerator href="help generator file"/>
   <diagnostics suppressReturningExceptions="true|false" />
</webServices>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Nessuno.

Elementi figlio

Elemento figlio Descrizione

diagnostics

Specifica se restituire le eccezioni al client a scopo di debug.

protocols

Specifica i protocolli che un servizio Web ASP.NET può utilizzare per ricevere dati di richiesta inviati da un client e restituire 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.

serviceDescriptionFormatExtensionTypes

Consente di specificare l'estensione di formato di descrizione servizio da eseguire nell'ambito del file di configurazione.

soapExtensionTypes

Specifica le estensioni SOAP utilizzate per controllare o modificare il messaggio SOAP durante l'elaborazione del servizio o client Web. Le estensioni SOAP estendono la funzionalità dei servizi Web.

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

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

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.

Elementi padre

Elemento Descrizione

configuration

È l'elemento radice in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

system.web

Consente di specificare l'elemento radice per la sezione di configurazione ASP.NET.

Esempio

Nell'esempio che segue vengono specificate le impostazioni di configurazione dei servizi Web XML.

<configuration>
   <system.web>
      <webServices>
         <diagnostics suppressReturningExceptions="false"/>
         <protocols>
            <add name="HttpGet"/>
            <add name="HttpPost"/>
            <add name="Documentation"/>
         </protocols>
         <serviceDescriptionFormatExtensionTypes>
         </serviceDescriptionFormatExtensionTypes>
         <soapExtensionTypes>
         </soapExtensionTypes>
         <soapExtensionReflectorTypes>
         </soapExtensionReflectorTypes>
         <soapExtensionImporterTypes>
         </soapExtensionImporterTypes>
         <wsdlHelpGenerator href="DefaultSdlHelpGenerator.aspx"/>
      </webServices>
   </system.web>
</configuration>

Vedere anche

Riferimento

Schema delle impostazioni dei servizi Web

Altre risorse

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