Web Services-Einstellungsschema
Dieses Thema bezieht sich auf eine veraltete Technologie. XML-Webdienste und XML-Webdienstclients sollten nun mithilfe der folgenden Technologie erstellt werden: Windows Communication Foundation.
Das Einstellungsschema für Webdienste definiert Konfigurationsdateielemente, die das Verhalten von ASP.NET-Webdiensten und deren Clients steuern. Das übergeordnete Element ist <webServices>.
Standardmäßig werden das <webServices>-Element und seine Nachfolger auf jeden Webdienst und jede Proxyklasse, auf die die Konfiguration zutrifft, angewendet. Die Konfiguration wird gemäß dem Anwendungstyp übernommen, wie im Folgenden dargestellt:
ASP.NET-Webanwendung (Dienst oder Client): Informationen zu Standardregeln für Konfigurationsvererbung, Bereichsauswahl und Prioritätensetzung innerhalb einer ASP.NET-Webanwendung finden Sie unter ASP.NET-Konfigurationsdateihierarchie und Vererbung. Das <webServices>-Element wird üblicherweise in einer Web.config-Datei platziert.
Eigenständige .NET Framework-Anwendung (nur Client): Siehe Anwendungskonfigurationsdateien. Das <webServices>-Element wird üblicherweise in der Konfigurationsdatei der Anwendung eingefügt.
Das <webServices>-Element und seine Nachfolger werden für die folgenden Arten von Klassen übernommen:
Eine Webdienstklasse, die von WebService abgeleitet wird.
Eine Clientproxyklasse, die indirekt von WebClientProtocol abgeleitet wird.
Ein <webServices>-Element kann sowohl auf einen Webdienst als auch auf einen Client angewendet werden, wenn eine Webanwendung beide Entitäten enthält.
<configuration>
<system.web>
<webServices>
<protocols>
<add>
<remove>
<clear>
<serviceDescriptionFormatExtensionTypes>
<add>
<remove>
<clear>
<soapExtensionTypes>
<add>
<remove>
<clear>
<soapExtensionImporterTypes>
<add>
<remove>
<clear>
<soapExtensionReflectorTypes>
<add>
<remove>
<clear>
<wsdlHelpGenerator>
| Element | Beschreibung |
|---|---|
<add> für <protocols> |
Fügt ein angegebenes Protokoll hinzu, das ein ASP.NET-Webdienst verwenden kann, um die von einem Client gesendeten Anforderungsdaten zu empfangen und Antwortdaten zurückzugeben. |
Fügt eine angegebene SDFE-Klasse (Service DescriptionFormat Extension, Dienstbeschreibungs-Formaterweiterung) hinzu, die definiert, wie die für Webdienste generierten Dienstbeschreibungen (WSDL-Dokumente) erweitert werden. |
|
Fügt eine angegebene SOAP-Erweiterungsklasse hinzu, die eine erweiterte Verarbeitung von SOAP-Nachrichten auf dem Webdienst oder -client ermöglicht. |
|
Fügt eine angegebene Importiererklasse 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. |
|
Fügt eine angegebene SOAP-Erweiterungsreflektorklasse hinzu, die den Generierungsprozess der Dienstbeschreibung (WSDL-Dokument) für die Verwendung mit einer Dienstbeschreibungs-Formaterweiterung (SDFE) erweitert. |
|
Entfernt alle zum übergeordneten Tag gehörenden Verweise auf Elemente. |
|
Gibt die Protokolle an, die ein ASP.NET-Webdienst verwenden kann, um die von einem Client gesendeten Anforderungsdaten zu empfangen und Antwortdaten zurückzugeben. Ein Protokoll kann dazu verwendet werden, Anforderungsdaten mit einer Methode und ihren Parametern zu verknüpfen sowie Antwortdaten mit der Methode und ihrem Rückgabewert zu verknüpfen. |
|
<remove> für <protocols> |
Entfernt ein angegebenes Protokoll zur Handhabung der Anforderungs- und Antwortdaten aus dem Gültigkeitsbereich der Konfigurationsdatei. |
Entfernt eine angegebene SDFE-Klasse (Dienstbeschreibungs-Formaterweiterung) aus dem Gültigkeitsbereich der Konfigurationsdatei. |
|
Entfernt eine angegebene SOAP-Erweiterungsklasse aus dem Gültigkeitsbereich der Konfigurationsdatei. |
|
Entfernt eine angegebene Importiererklasse für SOAP-Erweiterungen aus dem Gültigkeitsbereich der Konfigurationsdatei. |
|
Entfernt eine angegebene Reflektorklasse für SOAP-Erweiterungen aus dem Gültigkeitsbereich der Konfigurationsdatei. |
|
Gibt die SDFE-Klassen (Dienstbeschreibungs-Formaterweiterung) an, die zum Erweitern der für Webdienste generierten WSDL-Dokumente verwendet werden. Mit SDFE-Klassen lassen sich SOAP-Erweiterungen beschreiben. |
|
Gibt Importiererklassen für SOAP-Erweiterungen an, die den Clientproxy-Generierungsprozess erweitern. Zur Verwendung mit Dienstbeschreibungs-Formaterweiterungen (SDFEs - Service Description Format Extensions). |
|
Gibt Reflektorklassen für SOAP-Erweiterungen an, die den Generierungsprozess der Dienstbeschreibung (WSDL-Dokument) erweitern. Zur Verwendung mit Dienstbeschreibungs-Formaterweiterungen (SDFEs - Service Description Format Extensions). |
|
Gibt die SOAP-Erweiterungen an, die verwendet werden, um die SOAP-Nachricht während der Verarbeitung auf dem Webdienst oder -client zu überprüfen oder zu ändern. SOAP-Erweiterungen erweitern die Funktionalität von Webdiensten. |
|
Steuert die Einstellungen von Webdiensten, die mithilfe von ASP.NET bereitgestellt werden, und von Webdienstclients, die auf .NET Framework ausgeführt werden. |
|
Gibt die Webdiensthilfeseite (eine ASPX-Datei) an, die in einem Browser angezeigt wird, wenn dieser direkt zu einer ASMX-Webdienstseite navigiert. |
Siehe auch
Weitere Ressourcen
ASP.NET Settings Schema
Mit ASP.NET- und XML-Webdienstclients erstellte XML-Webdienste