<add>-Element 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. Ein Protokoll kann verwendet werden, um Anforderungsdaten mit einer Methode und ihren Parametern und Antwortdaten mit der Methode und ihrem Rückgabewert zu verknüpfen.

<configuration>

  <system.web>

    <webServices>-Element

      <protocols>-Element

        <add>-Element für <protocols>

<add name="protocol name"/>

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
name	Erforderliches Attribut. Der Name des hinzuzufügenden Protokolls.

name-Attribut

Wert	Beschreibung
HttpGet	Fügt das HTTP GET-Protokoll hinzu. Methodenparameter werden in der Form ?name1=value1&name2=value2… an die Abfragezeichenfolge übergeben, die an die URL der HTTP-Anforderung angehängt ist. Der Rückgabewert wird als einfaches XML-Dokument (ohne <soap:Envelope>) im Hauptteil der HTTP-Antwort abgelegt.
HttpPost	Fügt das HTTP POST-Protokoll hinzu. Methodenparameter werden in der Form name1=value1&name2=value… an den Hauptteil der HTTP-Anforderung übergeben. Der Rückgabewert wird als einfaches XML-Dokument (ohne <soap:Envelope>) im Hauptteil der HTTP-Antwort abgelegt.
HttpSoap	Fügt das HTTP SOAP-Protokoll hinzu. Eine SOAP-Nachricht wird an den Hauptteil der HTTP-Anforderung gesendet und die SOAP-Antwort an den Hauptteil der HTTP-Antwort.
Documentation	Fügt das spezielle Documentation-Protokoll hinzu. Wenn dieses Protokoll aktiviert ist und die ASMX-Seite direkt angefordert wird, führt ASP.NET eine Hilfsseite aus, um eine HTML-Dokumentationsseite zu erstellen, die an den anfordernden Client gesendet wird.

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

Referenz

<webServices>-Element
<protocols>-Element

Weitere Ressourcen

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

Copyright © 2007 by Microsoft Corporation. Alle Rechte vorbehalten.