Elemento <add> per <soapExtensionTypes>

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

Aggiunge una classe di estensioni SOAP specificata che fornisce un'elaborazione estesa dei messaggi SOAP sul client o sul servizio Web.

Gerarchia dello schema

<configuration>
  <system.web>
    Elemento <webServices>
      Elemento <soapExtensionTypes>
        Elemento <add> per <soapExtensionTypes>

Sintassi

<add type="fully qualified type name [,Version=version number] [,Culture=culture] [,PublicKeyToken= token]"
   priority="number"
   group="0|1"/>

Attributi ed elementi

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

Attributi

Attributo	Descrizione
type	Attributo obbligatorio. Specifica la classe delle estensioni SOAP da aggiungere. Il valore dell'attributo type deve trovarsi su una riga e includere il nome completo del tipo. Quando l'assembly viene inserito nella Global Assembly Cache (GAC) deve includere anche la versione, le impostazioni cultura e il token di chiave pubblica dell'assembly firmato.
priority	Attributo obbligatorio. Insieme all'attributo group, specifica l'ordine relativo in cui viene eseguita un'estensione SOAP quando vengono configurate per l'esecuzione più estensioni SOAP. All'interno di ciascun attributo group, l'attributo priority distingue la priorità relativa globale dell'estensione SOAP. Un valore priority più basso indica una priorità più elevata dell'estensione SOAP. Il valore più basso per l'attributo priority è 1.
group	Attributo obbligatorio. Insieme all'attributo priority, specifica l'ordine relativo in cui viene eseguita un'estensione SOAP quando vengono configurate per l'esecuzione più estensioni SOAP.

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.
soapExtensionTypes	Specifica le estensioni SOAP utilizzate per ispezionare o modificare il messaggio SOAP durante l'elaborazione del servizio o client Web. Le estensioni SOAP aumentano la funzionalità dei servizi Web.
system.web	Consente di specificare l'elemento radice per la sezione di configurazione ASP.NET.
webServices	Verifica le impostazioni dei servizi Web distribuite utilizzando ASP.NET e dei client dei servizi Web in esecuzione su .NET Framework.

Esempio

Nell'esempio riportato di seguito viene aggiunta una classe di estensioni SOAP. Tenere presente che il valore del tipo deve trovarsi su un'unica riga.

<configuration>
   <system.web>
      <webServices>
         <soapExtensionTypes>
            <add type="Contoso.Extensions.MySoapExtension, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"  priority="2" group="0"/>
         </soapExtensionTypes>
      </webServices>
   </system.web>
</configuration>

Vedere anche

Riferimento

Elemento <webServices>
Elemento <soapExtensionTypes>
SoapExtension

Concetti

Modifica di messaggi SOAP utilizzando estensioni SOAP

Altre risorse

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