<add>-Element für <soapExtensionImporterTypes>

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 Importerklasse für SOAP-Erweiterungen hinzu, die den Clientproxy-Generierungsprozess für die Verwendung in Verbindung mit einer Dienstbeschreibungs-Formaterweiterung (SDFE - Service Description Format Extension) erweitert.

Schemahierarchie

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

Syntax

<add type="soap extension class" 
     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 hinzuzufügende Importiererklasse für SOAP-Erweiterungen an.
priority	Erforderliches Attribut. Gibt gemeinsam mit group die relative Reihenfolge an, in der ein SOAP-Erweiterungsimportierer ausgeführt wird, wenn die Ausführung mehrerer SOAP-Erweiterungsimportierer konfiguriert ist. Das priority-Attribut innerhalb einer group differenziert die allgemeine relative Priorität des SOAP-Erweiterungsimportierers. Je geringer der priority-Wert, desto höher die Priorität für den SOAP-Erweiterungsimportierer. Der geringst mögliche Wert für das priority-Attribut ist 1.
group	Erforderliches Attribut. Gibt gemeinsam mit priority die relative Reihenfolge an, in der ein SOAP-Erweiterungsimportierer ausgeführt wird, wenn die Ausführung mehrerer SOAP-Erweiterungsimportierer konfiguriert ist. Die möglichen Werte sind wie folgt: 0: Gibt an, dass der SOAP-Erweiterungsimportierer in der Gruppe der SOAP-Erweiterungsimportierer mit der höchsten Priorität ausgeführt wird. 1: Gibt an, dass der SOAP-Erweiterungsimportierer in der Gruppe der SOAP-Erweiterungsimportierer mit der niedrigsten Priorität ausgeführt wird.

Untergeordnete Elemente

Keins.

Übergeordnete Elemente

Element	Beschreibung
configuration	Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
soapExtensionImporterTypes	Gibt Importiererklassen für SOAP-Erweiterungen an, die den Generierungsprozess des Clientproxys erweitern (nur für Webdienstclients).
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 Importiererklasse für SOAP-Erweiterungen hinzugefügt.

<system.web>
   <webServices>
      <soapExtensionImporterTypes>
         <add type="MyImporter priority="2" group="0"/>
      </soapExtensionImporterTypes>
   </webServices>
</system.web>

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Anpassen der Generierung von Dienstbeschreibungen und Proxyklassen.

Verweis

<webServices>-Element
<soapExtensionImporterTypes>-Element
SoapExtensionImporter

Weitere Ressourcen

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