Condividi tramite


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

<configuration>

  <system.web>

    Elemento <webServices>

      Elemento <protocols>

        Elemento <add> per <protocols>

<add name="protocol name"/>

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre.

Attributi

Attributo Descrizione

name

Attributo obbligatorio.

Nome del protocollo da aggiungere.

Attributo name

Valore Descrizione

HttpGet

  • Aggiunge il protocollo HTTP GET. I parametri di metodo vengono passati nella stringa di query che viene aggiunta all'URL della richiesta HTTP nel formato ?nome1=valore1&nome2=valore2…. Il valore restituito viene inserito nel corpo della risposta HTTP come documento XML semplice (non <soap:Envelope>).

HttpPost

Aggiunge il protocollo HTTP POST. I parametri di metodo vengono passati nel corpo della richiesta HTTP nel formato nome1=valore1&nome2=valore…. Il valore restituito viene inserito nel corpo della risposta HTTP come documento XML semplice (non <soap:Envelope>).

HttpSoap

Aggiunge il protocollo HTTP SOAP. Un messaggio SOAP viene inviato nel corpo della richiesta HTTP. La risposta SOAP viene inviata nel corpo della risposta HTTP.

Documentation

Aggiunge il protocollo speciale Documentation. Quando questo protocollo è attivato e la pagina ASMX viene richiesta in modo diretto, in ASP.NET viene eseguita una pagina di supporto per creare una pagina di documentazione HTML che viene inviata al client richiedente.

Elementi figlio

Nessuno.

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. Contiene gli elementi per la configurazione di applicazioni Web ASP.NET e il controllo del comportamento delle stesse.

webServices

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

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.

Osservazioni

I quattro protocolli disponibili si avvalgono tutti di HTTP/1.1 (Hypertext Transfer Protocol) per il trasferimento. I valori di protocollo HttpGet e HttpPost utilizzano i metodi GET e POST di HTTP. Il valore HttpSoap utilizza anche il metodo POST, ma senza la semantica HTTP POST tradizionale utilizzata da un form HTML.

Esempio

Nell'esempio riportato di seguito vengono attivati tutti e quattro i protocolli supportati.

<configuration>
   <system.web>
      <webServices>
         <protocols>
            <add name="HttpSoap"/>
            <add name="HttpPost"/>
            <add name="HttpGet"/>
            <add name="Documentation"/>
         </protocols>
      </webServices>
   </system.web>
</configuration>

Vedere anche

Riferimenti

Elemento <webServices>
Elemento <protocols>

Altre risorse

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

Footer image

Copyright © 2007 Microsoft Corporation. Tutti i diritti riservati.