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