<webServices>-Element

Artikel
02/27/2011

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

Steuert die Einstellungen von Webdiensten, die mithilfe von ASP.NET bereitgestellt werden, und von Webdienstclients, die auf .NET Framework ausgeführt werden.

Schemahierarchie

<configuration>
<system.web>
<webServices>-Element

Syntax

<webServices> 
   <protocols> 
      <add name="protocol name"/>
      <remove name="protocol name"/>
      <clear/>
   </protocols>
   <serviceDescriptionFormatExtensionTypes> 
      <add type="type"/>
      <remove type="type"/>
      <clear/>
   </serviceDescriptionFormatExtensionTypes>
   <soapExtensionTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionTypes>
   <soapExtensionReflectorTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionReflectorTypes>
   <soapExtensionImporterTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionImporterTypes>
   <wsdlHelpGenerator href="help generator file"/>
   <diagnostics suppressReturningExceptions="true|false" />
</webServices>

Attribute und Elemente

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

Attribute

Keine.

Untergeordnete Elemente

Untergeordnetes Element	Beschreibung
diagnostics	Gibt an, ob Ausnahmen zu Debugzwecken an den Client zurückgegeben werden.
protocols	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.
serviceDescriptionFormatExtensionTypes	Gibt die Dienstbeschreibungs-Formaterweiterung an, die innerhalb des Gültigkeitsbereichs der Konfigurationsdatei ausgeführt 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.
soapExtensionReflectorTypes	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).
soapExtensionImporterTypes	Gibt Importiererklassen für SOAP-Erweiterungen an, die den Clientproxy-Generierungsprozess erweitern. Zur Verwendung mit Dienstbeschreibungs-Formaterweiterungen (SDFEs - Service Description Format Extensions).
wsdlHelpGenerator	Gibt die Webdiensthilfeseite (eine ASPX-Datei) an, die in einem Browser angezeigt wird, wenn dieser direkt zu einer ASMX-Webdienstseite navigiert.

Übergeordnete Elemente

Element	Beschreibung
configuration	Das Stammelement in jeder Konfigurationsdatei, das von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
system.web	Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.

Beispiel

Im folgenden Beispiel werden verschiedene Konfigurationseinstellungen für den XML-Webdienst angegeben.

<configuration>
   <system.web>
      <webServices>
         <diagnostics suppressReturningExceptions="false"/>
         <protocols>
            <add name="HttpGet"/>
            <add name="HttpPost"/>
            <add name="Documentation"/>
         </protocols>
         <serviceDescriptionFormatExtensionTypes>
         </serviceDescriptionFormatExtensionTypes>
         <soapExtensionTypes>
         </soapExtensionTypes>
         <soapExtensionReflectorTypes>
         </soapExtensionReflectorTypes>
         <soapExtensionImporterTypes>
         </soapExtensionImporterTypes>
         <wsdlHelpGenerator href="DefaultSdlHelpGenerator.aspx"/>
      </webServices>
   </system.web>
</configuration>

Siehe auch

Verweis

Web Services-Einstellungsschema

Weitere Ressourcen

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