Freigeben über


<protocols>-Element

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

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.

Schemahierarchie

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

Syntax

<protocols> 
      <add name="protocolname"/>
      <remove name="protocolname"/>
      <clear>   
</protocols>

Attribute und Elemente

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

Attribute

Keine.

Untergeordnete Elemente

Element Beschreibung

add

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. Standardmäßig werden nur HttpSoap und Documentation aktiviert.

clear

Entfernt alle Protokolle aus dem Gültigkeitsbereich der Konfigurationsdatei.

remove

Entfernt ein angegebenes Protokoll zur Handhabung von Anforderungs- und Antwortdaten aus dem Gültigkeitsbereich der Konfigurationsdatei.

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

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 werden alle vier unterstützten Protokolle aktiviert. Standardmäßig werden nur HttpSoap und Documentation aktiviert. Um HttpPost und HttpGet zu verwenden, müssen Sie diese wie im folgenden Beispiel gezeigt aktivieren.

<configuration>
   <system.web>
      <webServices>
         <protocols>
            <add name="HttpSoap"/>
            <add name="HttpPost"/>
            <add name="HttpGet"/>
            <add name="Documentation"/>
         </protocols>
      </webServices>
   </system.web>
</configuration>

Siehe auch

Verweis

<webServices>-Element

Weitere Ressourcen

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