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.

Elemento <Configuration>
  Elemento system.web (schema delle impostazioni ASP.NET)
    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 di primo livello 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.

Note

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

Impostazioni di configurazione di ASP.NET
Servizi Web creati mediante ASP.NET e client di servizi Web XML
ASP.NET Configuration