Freigeben über


<add>-Element für <protocols>

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 ein angegebenes Protokoll hinzu, das 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
        <add>-Element für <protocols>

Syntax

<add name="protocol name"/>

Attribute und Elemente

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

Attribute

Attribut Beschreibung

name

Erforderliches Attribut.

Der Name des hinzuzufügenden Protokolls.

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.

system.web

Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an. Enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern.

webServices

Steuert die Einstellungen von Webdiensten, die mithilfe von ASP.NET bereitgestellt werden, und von Webdienstclients, die auf .NET Framework ausgeführt 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.

Hinweise

Alle vier möglichen Protokolle werden über HTTP/1.1 (Hypertext Transfer Protocol) übertragen. Der HttpGet-Protokollwert und der HttpPost-Protokollwert verwenden die GET-Methode und die POST-Methode von HTTP. Der HttpSoap-Wert verwendet auch die POST-Methode, jedoch ohne die in einem HTML-Formular verwendete herkömmliche HTTP POST-Semantik.

Beispiel

Im folgenden Beispiel werden alle vier unterstützten Protokolle aktiviert.

<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
<protocols>-Element

Weitere Ressourcen

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