<add>-Element für <soapExtensionTypes>

Dieses Thema bezieht sich auf eine veraltete Technologie. XML-Webdienste und XML-Webdienstclients sollten nun mithilfe der folgenden Technologie erstellt werden: Windows Communication Foundation.

Fügt eine angegebene SOAP-Erweiterungsklasse hinzu, die eine erweiterte Verarbeitung von SOAP-Nachrichten auf dem Webdienst oder -client ermöglicht.

Schemahierarchie

<configuration>
  <system.web>
    <webServices>-Element
      <soapExtensionTypes>-Element
        <add>-Element für <soapExtensionTypes>

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
type	Erforderliches Attribut. Gibt die SOAP-Erweiterungsklasse an, die hinzugefügt werden soll. Der Wert des type-Attributs muss sich in einer Zeile befinden und den vollständigen Typnamen enthalten. Wenn die Assembly im Global Assembly Cache (GAC) platziert wird, muss sie auch Version, Kultur und öffentliches Schlüsseltoken der signierten Assembly beinhalten.
priority	Erforderliches Attribut. Gibt gemeinsam mit group die relative Reihenfolge an, in der eine SOAP-Erweiterung ausgeführt wird, wenn die Ausführung mehrerer SOAP-Erweiterungen konfiguriert ist. Das priority-Attribut dient innerhalb einer jeden group zur Unterscheidung der allgemeinen relativen Priorität der SOAP-Erweiterung. Je kleiner die priority-Zahl, desto höher die Priorität der SOAP-Erweiterung. Der kleinste mögliche Wert für das priority-Attribut ist 1.
group	Erforderliches Attribut. Gibt gemeinsam mit priority die relative Reihenfolge an, in der eine SOAP-Erweiterung ausgeführt wird, wenn die Ausführung mehrerer SOAP-Erweiterungen konfiguriert ist.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibung
configuration	Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
soapExtensionTypes	Gibt die SOAP-Erweiterungen an, die verwendet werden, um die SOAP-Meldung während der Verarbeitung auf dem Webdienst oder -client zu überprüfen oder abzuändern. SOAP-Erweiterungen erweitern die Funktionalität von Webdiensten.
system.web	Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.
webServices	Steuert die Einstellungen von Webdiensten, die mithilfe von ASP.NET bereitgestellt werden, und von Webdienstclients, die auf .NET Framework ausgeführt werden.

Beispiel

Im folgenden Beispiel wird eine SOAP-Erweiterungsklasse hinzugefügt. Beachten Sie, dass der Typwert sich auf einer Zeile befinden muss.

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

Siehe auch

Verweis

<webServices>-Element
<soapExtensionTypes>-Element
SoapExtension

Konzepte

SOAP-Nachrichtenänderung mit SOAP-Erweiterungen

Weitere Ressourcen

ASP.NET Settings Schema
Mit ASP.NET- und XML-Webdienstclients erstellte XML-Webdienste